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PREFACE 


The TOPS-20 User Utilities Guide is intended for both the privileged 
and the nonpr ivileged user who needs information on utility programs 
that run on the TOPS-20 operating system. Before you use this manual, 
you should be familiar with the information contained in Getting 
Started with TOPS-20 , the TOPS-20 User's Guide , and the TOPS-2 0 
Commands Reference Manual . 

This document provides detailed information on the following TOPS-20 
utility programs: MAIL, RDMAIL , FILCOM, CREF, MAKLIB, DUMPER, and 
PLEASE. The manual contains tutorial and reference material in each 
chapter to accommodate both the novice and the experienced user. 

The following conventions are used throughout the TOPS-20 User 
Utilities Guide : 

( HD 


( ESC ) 


GED 

((TRL \) 


file spec 

red print 


Indicates when you should press the RETURN key (on 
some terminals the key labeled CR) 

Indicates when you should press the ESC key (on some 
terminals the key labeled ALT) 

Indicates when you should press the DELETE key 

Indicates when you should hold down the CTRL key and 
at the same time type the letter x 

Indicates a file specification 

Indicates anything you type or are expected to type 
on your terminal. 
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The following TOPS-20 documents are referenced in this manual: 
Getting Started With TQPS-20 ( AA-41 87D-TM) 

TOPS-20 User's Guide ( AA-4 1 79C-TM) 

TQPS-20 Commands Reference Manual (AA-511 5B-TM) 

TOPS-20 Operator's Guide ( AA-4176D-TM) 

TOPS-20 Monitor Calls Reference Manual (AA-41 66D-TM) 
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CHAPTER 1 


INTRODUCTION TO TOPS-20 USER UTILITIES 


This manual describes utility programs available to any user of the 
TOPS-20 operating system. 

The following utility programs are covered in this manual: 

• The MAIL program, which allows you to send messages to other 
users of the system (Chapter 2) 

• The RDMAIL program, which allows you to read messages sent to 
you via the MAIL program (Chapter 3) 

a The FILCOM program, which allows you to compare two ASCII 
files or two binary files (Chapter 4) 

© The CREF program, which produces cross-reference listings of 
symbols used in MACRO, FORTRAN, and ALGOL programs (Chapter 5) 

• The MAKLIB program, which performs various functions on 
libraries of relocatable object modules (Chapter 6) 

a The DUMPER program, which allows you to save files and 
directories on tape, and restore these files and directories 
to disk (Chapter 7) 

a The PLEASE program, which allows you to communicate with the 
system operator (Chapter 8) . 


1.1 INVOKING THE UTILITIES 

To invoke these utilities, you should be familiar with the TOPS-20 
log-in procedure. Type the name of the program after the TOPS-20 
prompt @ and press RETURN. The utility then prompts you for input. 
Thus, the general format is: 

(j) lit i I i ty Name C ret ) 

IJt i 1 ity prompt 


1.2 TYPING FILE SPECIFICATIONS 

Many of the utilities accept file specifications as arguments. There 
are two forms of file specifications. The MAIL, RDMAIL, and DUMPER 
utilities accept file specifications in the following format: 

dev : <dir >name . typ .gen ;att; . . . ;att 
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where : 


dev : 


Indicates a device name, a file structure name 
or a defined logical name 


<dir > 


Indicates a directory name 


name 


Indicates the filename of a particular file in 
the directory 


•typ 


Indicates a file type that helps identify the 
contents of the file 


.gen 


Indicates a generation number that shows the 
number of times a file has been changed 


; a tt 


Indicates a file attribute such as a file 
protection or an account string. 


If you omit the dev: field of the file ’specification, the system 
assumes that you mean your connected structure. When you omit the 
<dir> field of the file specification, the system assumes that you 
mean your connected directory. When you omit the .gen field of the 
file specification, the system assumes that you mean the highest 
generation (largest generation number) for source files. For 
Destination files, the system assumes that you mean the highest 
generation plus one. 

You can use recognition on file specifications in this format. You 
can use wildcards only in the DUMPER program. (Refer to Chapter 7.) 
For more information on file specifications, refer to the TOPS-20 
User 1 s Guide . 

The FILCOM, CREF, and MAKLIB utilities accept file specifications in a 
slightly different format as follows: 

dev : name . typ [ PPN ] 

In this form of a file specification, filenames are restricted to six 
characters. File types are restricted to three characters. You 
cannot use recognition, and file generation numbers are not allowed. 
Therefore, the highest generation of a file is always used. You can 
use wildcards only in the MAKLIB program. (Refer to Chapter 6.) 

The PPN is a project-programmer number, which you use instead of a 
directory name. To find out the PPN associated with a specific 
directory, give the TRANSLATE command. For example, if you wish to 
find out the PPN associated with the directory <ADLEY> on PS: you do 
the following: 

(» TRANSLATE < D I R E C T 0 R Y > P S t < A D L E Y >CBD 
P S J < A D L E Y > < I S > P S i C 4 » 3 0 5 II 
0 

You can avoid using PPN ' s in file specifications by defining a logical 
name that represents the directory you wish to access. Do the 
following procedure: 

1. Give the DEFINE command to define a logical name as the 
directory . 

2. Use the logical name in place of the device name and the PPN 
when you type the file specification. 
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The following is an example of defining a logical name for a directory 
and using it with the FILCOM program: 

& DEFINE (LOGICAL NAME) ADL« (AS) <ADLEY>C«D 
(? filcomGD 

>K TTY J =ADL J TEST . MAC » ADL : TEST2 . MACQD 

You can also define logical names to reference long filenames or 
particular file generation numbers. This is especially useful with 
the FILCOM program when you wish to compare two similar files with 
different generation numbers. For example: 

6 DEFINE (LOGICAL NAME) AJ (AS) F0Q.BAR.3 C «t ) 

@ DEFINE (LOGICAL NAME) EC (AS) F00 . BAR . 4C“D 
g> filcomGID 
# tty: -a; >b:GD 
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CHAPTER 2 


THE MAIL PROGRAM 


2.1 INTRODUCTION 

You can use the MAIL program to send messages to other users of the 
system. You can send mail to a single user or to a group of users who 
are either logged in or not logged in. 


2.2 RUNNING MAIL 

To run MAIL , type MAIL after the TOPS-20 prompt @ and press the RETURN 
key. The program responds with the To: prompt as follows: 

(3 MAI lChD 

Tot 

Type the name of the user to whom you are sending the message, and 
press RETURN. 

If you are sending a message to a group of users, type the names, 
separating them with commas, and press RETURN. For example: 

j o ♦ A d 1 e y * S a r t :i. n i v M c E 3. m o y 3. e ( ) 

The program then prompts: 


CCt 

Now list any secondary recipients of your message. Type the name or 
names (separated by commas) and press RETURN. If you do not want to 
send a copy to others, simply press RETURN after the CC: prompt. 

If you type an invalid (nonexistent) user name, the program responds 
wi th : 


? I n v a 1 i d u s e r n a in e 

MAIL returns with either the To: prompt or the CC: prompt. Type 

CTRL/H after either prompt. This retrieves only the names up to the 
error, and you can type any additional valid names. 

You cannot send more than one copy of a mail message to a user. If 
you type a user name more than once after either the To: or the CC : 
prompt, the program prints a warning message. For example: 

To I Adley C RET ) 

CCt A d 1 e y CUD 

% D u p 1 i c a f e ri a m e p u r«2ed - A D L E Y 
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The MAIL program continues after it prints the warning message; 
however, the program removes the duplicate name from the list of 
users . 

The program then prompts with: 

Subject t 

Type a description of the message and press RETURN. For example: 

S u b J e e 1 1 L o c a t i o n o f w e e k .1. y w r i t e T' s in e e t :i. n d ( RET ) 

If your description exceeds one line, you cannot continue the 
description on a second line; you must continue typing when you reach 
the end of a line. The system automatically continues your 
description on the second line by responding with a carriage return 
line feed sequence. When you have completed typing your description, 
press RETURN. For example: 

Subject* Location of weekly meeting and chan.de in software 
release date + C *et ) 


NOTE 

The system may interpret a character in 
the Subject: line (such as a question 
mark) as a special character. To avoid 
this, precede the character with a 
CTRL/V. 


MAIL then prompts with: 

M e s s a d e ( T e r iti : i. n a t e w i t h E S C o r C T E L /Z ) t 

and waits for you to enter your message. Once you have terminated 
your message by typing ESC or CTRL/Z, the program informs you that it 
has processed your message: 

P r o c e s s :i. n d m a :i. 1 ♦ ♦ ♦ 


No errors ♦ 

-•DONE- 

and returns you to TOPS-20 command level. 

If you send a message to a user who is logged in and accepting links 
and system messages, that user is informed immediately as follows: 

I You have a message from SENDEE “I 

If you send a message to a user who is not logged in, that user is 
informed the next time he logs in: 

0L.OGIN (USER) ADLEY (PASSWORD) (ACCOUNT) 34lC«D 

Job 54 on TTY33 23- Apt 79 09 * 46 * 05 

You have a message 

(» 
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If you make an error in sending mail to a user, you receive one of the 
following messages: 

CUSER NAME:] not sent BECAUSE t 
1 n v a 1 i d d i r e e t o r \.i n u m b e r 


or 


I n v a ]. i d s i m u 1 1 a n e o u s 3 e cess 


or 


No such file type (or some other reason related to why the 
recipient's MAIL . TXT file could not be found) 


CUSER NAMEII not sent BECAUSE ♦ 
D i is k e u o t a e x e e e d e d 


NOTE 

For additional information on these 
error messages, refer to Section 2.4, 
MAIL Messages. 


You can use a recovery procedure to resend mail after receiving some 
of the MAIL error messages. This recovery is particularly helpful 
when your message is long and you do not want to retype it. The 
procedure is as follows: 

1. Undelete the MAIL.CPY file in your logged-in directory. This 
file contains the message that could not be sent. 

2. Rename the MAIL.CPY file; for example, ERROR. TXT . This 

prevents MAIL from deleting the file a second time during 
message processing. 

3. After the TOPS-20 prompt §, type: 

& GET SYSJMAILQID 

4. The system gives the TOPS-20 prompt once again, and you type: 

0 reenterQE) 

5. After you press RETURN, the system prompts: 

File name of message file* 

Now type the new file spec of the renamed MAIL.CPY file, and 
press RETURN: 

File name of message file* (file spec >(jlhJ 

The MAIL program now proceeds as though you had just typed 
ESC or CTRL/Z after the message. 
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2.3 OPTIONS TO THE MAIL PROCEDURE 

The procedure in Section 2.2 describes the most common use of MAIL. 
Options to this basic procedure are as follows: 

1. You can use the TALK command as an alternative to the MAIL 
program to communicate with a user who is logged in. (For 
more information on the TALK command, refer to the TQPS-20 
Commands Reference Manual . ) 

2. You can use the INFORMATION MAIL command to check on the 
status of new mail, either your own or that of other users. 
(For more information on this command, refer to the TQPS-20 
Commands Reference Manual . ) 

3. If you send mail often to a group of users, you can create a 
file containing these names. Then, instead of typing all the 
names each time you send a message, you can type the 
filename, preceded by an @ , after the To: prompt or the CC : 
prompt. For example, if the file NAME.FIL.l contains the 
user names ADLEY, CRUGNOLA, LYONS, type: 

Tot ©NAME*FIL*lC 

The filename can also be combined with other user names 
following the prompt. However, the file must follow the list 
of additional user names. For example: 

To J Ssrtini > MeElmoy le y ©NAME ♦ FIL ♦ lQHD 

4. You can use the contents of an indirect file as your message 

or Subject: line text. The indirect file you use in the 

Subject: line can contain only one line. You cannot type 

any additional text on this line with the indirect file. To 
send the contents of an indirect file as mail, type an @ 

followed by the name of the file, and press RETURN. You 

cannot type any additional text before or after the indirect 
file. For example: 

BMAILQiD 

T o l C r u 3 n o 1 a ( RET ) 

CC l 

S u b J e o 1 1 M a c r o f :L 1 e s ( RFT ) 

M e s s a si e < T e r in :i. n a 1 e w :i. t h E S C o r C T E L / Z ) * 

©MACRO ♦ CMD ♦ iCsED 

P r o c e s s i n si m a i 1 ♦ ♦ ♦ 

No errors* 

-DONE- 

0 

In this case, you do not terminate the message with ESC or 
CTRL/Z, because you are using an indirect file as your 
message. However, you terminate the file spec by pressing 
RETURN. If you terminate your message with CTRL/Z, MAIL 
responds with: 


©MACRO ♦ CMD ♦ 1(ctruz) 

?Not confirmed 

To recover, type CTRL/H immediately to retrieve the indirect 
file spec. Then, press RETURN. 
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5. Normally, you send mail to other users. However, you can 
also send mail to any non-files-only directory on PS:. The 
most common non-files-only directories are PS:<REMARKS> and 
PS: <SYSTEM> . 

PS: <REMARKS> can be used for recording information and 
problems that the system staff should be aware of. For 
example, use PS:<REMARKS> to record any system difficulties, 
hardware/software problems, or other related items. To send 
a message to this directory, type REMARKS after the To: 
prompt. For example: 


0 MAIL C ret ) 

To X REMARKS 
C C ♦ ( RET ) 

S u b J e c t X S u p p ]. .i. e s ( *et ) 

M e s s a rJe < T e r m :i. n a t e w i t h E S C o r C T R L / Z ) ♦ 

Terminals i n R oom 216 need additional boxes of papery size 
9 7/8 x 11 ♦COD 

P r o e e s s :i. n 3 m a i 1 ♦ ♦ ♦ 


No errors* 

-DONE*- 

0 

Generally, to send messages to all users of the system, you 
enable your WHEEL or OPERATOR capabilities and run MAIL. 
These messages are called Messages-of-the-Day . You can also 
send Messages-of-the-Day by connecting to the directory 
PS:<SYSTEM>. However, most systems are not set up to allow 
users to connect to this directory. The following example 
shows an enabled user running MAIL to send a 
Message-of-the-Day . 

$ MAIL C ret ) 

To: SYSTEM (^iD 
CC ♦ ( ) 

S i.j b J e c t X S y s t e iti s h u t - d o w n C RET ) 

M e s s a <1 e < T e r in i n a t e w i t h E S C o r C T R L /Z ) X 

The system will be s hut down tomorrow at 5 p ♦ m ♦ for 
prevent i ve maintenance ♦ ( ESC ) 

P r o c e s n> :i. n <•* m a i 1 ♦ ♦ ♦ 


No errors* 

-BONE- 

$ 

If you attempt to send mail to PS:<SYSTEM> and do not enable 
WHEEL or OPERATOR capabilities, MAIL prints the following 
error message: 

P r o c e s s i n <3 m a i I ♦ ♦ ♦ S Y S T E M n o t s e n t B E C A U S I” ♦ 

W il E!.’ E L o r 0 P ERA T 0 R c a p a b i 1 i t u rea u i r e d 

To resend the mail, you can follow the recovery procedure 
described in Section 2.2 after you enable WHEEL or OPERATOR 
capabilities. 
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When you send a message to PS:<SYSTEM>, the following message 
appears on all terminals that are receiving system messages: 

1“ New M e s s a <3 e - o f - 1 h e •••• D a w a v a :i. 1 a b 1 e "I 

Users not logged in to the system at the time you send the 
message automatically receive new Messages-of-the-Day the 
next time they log in. 

6. You can use MAIL to inform yourself that your batch job is 
completed. Place commands to MAIL in your control file as 
shown in the following example. Note that a period is used 
as the reply to the To: prompt. This character replaces a 
user name and informs MAIL that the message is to be sent to 
you. For example: 

G* C R E A T E ( F I L E ) TEST* C T LCE D 
INPUT t TEST ♦ CTL 
00100 6FILC0M CUD 

00200 )KTEST * F0R-DIFFER * FOR y ADD EM * FOR /A C^D 
0 0 3 0 0 ©PRINT T E S T ♦ F 0 R® 

00400 ©MAIL.C HD 
00500 **CEID 

00600 *QiD 

00700 *BATCH JOB IS D0NE(«D 

00800 *~z 

00900 GiD 
*e ( ret ) 

© 


NOTE 

Use of a period in place of your user 
name when you run MAIL is not a feature 
unique to batch. You can use it any 
time in the MAIL program when you wish 
to specify yourself as a recipient of 
mail . 


2.4 MAIL MESSAGES 

The most common MAIL messages, their descriptions, and suggested user 
responses follow. Fatal errors are preceded by a question mark (?) . 
Warning messages are preceded by a percent sign (%) . 

%Duplicate name purged - [USER NAME] 

Description: You attempted to send a user more than one copy of 

a mail message. 

Suggested User Response: None. MAIL continues automatically, 
and eliminates the duplicate name. 
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?Invalid user name 

Description: You typed an invalid (nonexistent) user name as a 

recipient of your message. 

Suggested User Response: Type CTRL/H after either the To: 

prompt or the CC : prompt to retrieve only the names up to the 
error. Type any additional valid names. 

7MAIL.CPY Failure 

Entire file structure full 

Description: The public structure (PS:) is full, and therefore 

MAIL cannot operate. You receive this message immediately after 
invoking the program. 

Suggested User Response: Delete and expunge some files from your 
logged-in directory, or wait until some space is freed. 

? MAILER is not running. Messages not sent. 

Description: Your message was not sent because the MAILER 

program is not functioning. 

Suggested User Response: Send a message to the operator with the 
PLEASE program (refer to Chapter 8) to report that MAILER is not 
functioning. Then, once MAILER is functioning, use the recovery 
procedure described in Section 2.2 to resend your message. 

?Not confirmed 

Description: You did not press RETURN immediately after typing 

an indirect file spec. 

Suggested User Response: TYPE CTRL/H immediately after the error 
message to retrieve the indirect file spec. Then, press RETURN 
to confirm the indirect file spec. 

?Processing errors occurred. No mail sent. 

Description: There is a problem with you MAIL.CPY file; either 

MAILER cannot find it, or the file is not in correct format. 

Suggested User Response: Check to see if there is another 
program updating MAIL.CPY. If not, contact your Software 
Specialist or send a Software Performance Report (SPR) to 
DIGITAL. 

SYSTEM not sent BECAUSE: 

WHEEL or OPERATOR capability required 

Description: You attempted to send mail to PS:<SYSTEM> and did 

not enable WHEEL or OPERATOR capabilities. 

Suggested User Response: You must enable WHEEL or OPERATOR 

capabilities before sending mail to PS:<SYSTEM>. To resend the 
mail, you can follow the recovery procedure described in Section 
2.2 after you enable WHEEL or OPERATOR capabilities. 
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%Too many user names, 100 is maximum. 

Description: You specified too many users as recipients of your 

message. MAIL only allows up to 100 user names as recipients of 
a message; it sends your message to the first 100 names but 
ignores all that exceed the first 100. 

Suggested User Response: Send your message to the first 100 

names. Next, edit your MAIL.CPY file to retrieve the message 

text. Then , run MAIL to send the message to the additional 

names, using " to send the edited MAIL.CPY file as the message 

text. 

[USER NAME] not sent BECAUSE: 

Invalid directory number 

Description: You attempted to send mail to a nonexistent user 

directory . 

Suggested User Response: You cannot send mail to a user who does 
not have a directory. 

[USER NAME] not sent BECAUSE: 

Invalid simultaneous access 

Description: Another user has the receiver's MAIL . TXT file open 

for writing. 

Suggested User Response: Follow the recovery procedure described 
in Section 2.2 to resend the message. 

[USER NAME] not sent BECAUSE: 

No such file type (or some other related reason) 

Description: The intended receiver of your message has no 

MAIL. TXT file. 

Suggested User Response: Ask the user to create a MAIL . TXT file 
to receive mail messages. 

[USER NAME] not sent BECAUSE: 

Disk quota exceeded 

Description: The receiver's directory exceeds its working quota. 

Suggested User Response: Some files must be deleted from the 
directory before mail can be received. You can also enable WHEEL 
or OPERATOR capabilities to ignore the user's quota. If the user 
is logged in, you can use the TALK command as an alternative. 


2-8 



THE MAIL PROGRAM 


2.5 TECHNICAL NOTES 

MAIL works with another program called MAILER when it handles 
messages. When you type a mail message, MAIL creates a file, 
MAIL.CPY, in your logged-in directory. This file is closed when you 
complete your message input. At this point, MAIL sends an IPCF 
(Inter-Process Communication Facility) packet to the MAILER program to 
inform it that you want to send a message. (For more information on 
IPCF, refer to the TQPS-20 Monitor Calls Reference Manual .) MAILER 
processes the message by appending the contents of MAIL.CPY in your 
logged-in directory to the file MAIL.TXT in the recipient's logged-in 
directory. Then it sends an IPCF packet back to MAIL, which notifies 
you of the status of your message (sent or not sent) . At this point, 
the MAIL.CPY file is deleted from your logged-in directory. Figure 
2-1 shows the relationship between MAIL and MAILER. 


SENDER 1 RECEIVER 



Figure 2-1 The Relationship Between MAIL and MAILER 
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THE RDMAIL PROGRAM 


3.1 INTRODUCTION 

The RDMAIL program prints messages that have been sent to you by other 
users of the system through the MAIL program. Your MAIL.TXT file in 
your logged-in directory on PS: contains these messages. 


NOTE 

If your MAIL.TXT file contains mail sent 
by Version 4 of the MAIL program, you 
must use Version 4 of RDMAIL to read it. 


There are various ways that the system notifies you whenever there is 
mail that you have not read. If another user sends you mail while you 
are not logged in, you receive the following message the next time you 
log in: 


@ LOGIN ( USER ) DBELL ( PASSWORD ) < ACCOUNT > 
Job 33 on TTY42 29~AusS-79 16 t 14 : 12 
You have a message 

e 


Another user may send you a message while you 
case, the system types 

II You have a message from SENDER 3 
on your terminal. 

Messages-of- the-Day sent to you when you are not logged in are printed 
on your terminal automatically after you log in. However, if your 
directory is set to REPEAT LOGIN-MESSAGES, you receive all 
Messages-of- the-Day every time you log in. For more information on 
the REPEAT LOGIN-MESSAGES subcommand, refer to the BUILD command 
description in the TQPS-20 Commands Reference Manual . If a system 
message is sent while you are logged in and you are receiving system 
messages, you are notified immediately: 

II N e w M e s s a & e - o f - 1 h e - D ay av a i 1 a b 1 e 1 


are logged in. In this 
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You can give the SET MAIL-WATCH command to keep informed of any new 
mail you receive, especially if you have given the REFUSE 
SYSTEM-MESSAGES command. (For more information on these two commands, 
refer to the TQPS-20 Commands Reference Manual .) You can add the SET 
MAIL-WATCH command to your COMND.CMD file, if you have one, or type it 
each time you log in. When you give this command, it tells the system 
to notify you when you have new mail. You receive this notification 
only when you are at TOPS-20 command level. At intervals of 
approximately five minutes, the TOPS-20 Command Processor informs you 
that you have new mail whenever it prompts you for a new command. 
This message appears on your terminal: 

C Y o u h a v 0 n e w in a :i. 1 "I 

You may give the INFORMATION MAIL command, even if you are not logged 
in, to check on the status of new mail for yourself or other users. 
To do this, type the following: 

$ INFORMATION (ABOUT) MAIL (FOR USER) name C^T) 

The system returns with one of the following responses: 

New mail exists 

or 

N o n e w m ail e x i s t s 
or 


M a i 1 b c> x p r o t e c t e d 


3.2 RUNNING RDMAIL 

To start RDMAIL, type RDMAIL after the TOPS-20 prompt @ and press the 
RETURN key. The program responds with the date and time prompt as 
follows : 


<i»RDMAIL.C«D 

D a t e a n d t i in e ( / H E L.. P f o r h e 1 p ) 

If you have enabled WHEEL or OPERATOR capabilities, RDMAIL first asks 
you whether you want to read your own mail or that of another user. 
For example: 


$RDMAIL GOD 

Special user (w or n)? 

If you type y, you are indicating that you wish to read another user's 
mail. Type y and press RETURN. RDMAIL then prompts you to type the 
name of the user whose mail you wish to read. Type the user name and 
press RETURN. RDMAIL then prompts you for date and time input. For 
example : 

$RDMAILC EE) 

S p e c i a 3. u s e r ( w o r ri ) ? y ( ret ) 

U s e r n a m e ♦ D N 0 f f C ™ 1 
D 3 1 0 a n d t i in 0 ( / H E L P f o r h 0 1 p ) 
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If you type n, you are indicating that you wish to read your own mail. 
Type n and press RETURN. RDMAIL then prompts you for date and time 
input. For example: 

$ RDMAIL CUD 

Special user (s or n)? n ( ret ) 

D ate a n d t i m e ( / H £ L P f o r h e 1 p ) 


RDMAIL allows you to read your messages several ways: 

• By giving a date and/or time 

• By giving a program switch or combination of switches 

• By giving a date and/or time combined with one or more program 
switches . 

To read any new messages, simply press RETURN. 

You can define a time period of mail you wish to read. To do this, 
type a date and/or a time. A common TOPS-20 format is: 

MMM DD , YYYY HH:MM:SS 


For example, a valid date and time is May 22,1979 17:00:00. If you 
type only a date, RDMAIL assumes the time 00:01:00. If you type only 
a time, the program assumes the present date. RDMAIL responds by 
displaying all messages you received on and after the date and/or time 
you typed. 

If you type an invalid date or time, you receive an error message. 
Three of the most common ones are: 

? I n v a 1 :i. d d a t e f o r m a t 


or 


? I n v a 1 i d t :i. m e f o r m a t 
or 

?Day of month too lartfe 

After the error message RDMAIL returns with the prompt for you to type 
a valid date and/or time. 

Table 3-1 describes the RDMAIL switches you can use after the prompt, 
either alone or combined with date/time input. 
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Table 3-1 
RDMAIL Switches 


Switch 

Function 

/ALL 

Types all messages, regardless of date. 

/HELP 

Types the program help text, outlining the 
time/date format and program switches and 
their functions. 

/LIST 

Outputs messages to the line printer, 

rather than to your terminal. 

/MESSAGE-OF-THE-DAY 

Types messages from the system 
Message-of- the-Day file, rather than from 
your own message file. 

/PERUSE 

Allows you to peruse messages, and gives 
only the following information for each 
message : 

Date: From: To: CC : and Subject. 

/STOP 

Instructs RDMAIL to stop after each message 
it types. At the end of each message, the 
system prompts you to type RETURN for more 
output. 


3.2.1 Reading Mail Using RDMAIL Switches 

You type RDMAIL switches immediately following the prompt, and may or 
may not combine them with a date and/or time. You have the options of 
combining switches and preceding each switch with a space. To use 
RDMAIL switches, type a slash (/) followed by the switch name. 

/HELP - HELP Switch 

Type /HELP to get information. on running RDMAIL. For example: 

Of RDMAIL QED 

D a t e a n d t i iyi e ( / H E L P f o r h e 1 p ) /HE I... PQTP) 

After the help text prints on your terminal, the system returns with 
the prompt for you to type date/time information and/or another 
switch. 


NOTE 

/HELP overrides all other switches that 
you may combine with it. The system 
ignores all other specified switches in 
the combination, and prints the full 
RDMAIL help text. 


3-4 


THE RDMAIL PROGRAM 


/ALL - ALL Switch 

Type /ALL when you wish to read all messages in the mail file, 

regardless of date. 

/ALL may be combined with all other program switches except 
/HELP. If you type /ALL after the prompt. 


e RDMAIL r^T) 

D a t e a n d t i m e < / H E L P for' h e 1 p ) /a L L Chl) 

RDMAIL accesses all messages in your file. 

/LIST - LIST Switch 

Type /LIST when you want messages output to the line printer 

rather than to your terminal. /LIST can be combined with 

date/time input, and/or with /ALL. For example, 

® RDMAIL CmD 

Date and time (/HELP for help) May 13 r 1979 12 : 00 : 00 /LIST C^D 

Prints all messages in your file on and after 12:00:00 of May 
13, 1979 on the line printer. 

If you type only /ALL /LIST after the prompt, RDMAIL prints all 

messages in your file on the line printer. 

/MESSAGE-OF-THE-DAY - System Message Switch 

Type /MESSAGE-OF-THE-DAY to print mail from the system 
Message-of- the-Day file (PS : <SYSTEM>MAIL. TXT) , rather than from 
your own message file. Since new entries in the 
Message-of-the-Day file are typed on your terminal when you log 
in, you normally use this switch when a new Message-of-the-Day 
becomes available while you are logged in. /MESSAGE-OF-THE-DAY 
may be combined with date/time input. It may also be combined 
with all other program switches except /HELP. For example: 

E! New M e s s a3e - o f - 1 h e - D ay a v a i 1 a b I e 1 

grdmailGeD 

D a t e a n d t :i. m e ( / H E L P f o r help) /MESSAGE-GF-THE-DA YQeT) 


Date t 25 Jun 79 0853-EDT 
From t OPERATOR 
Tot SYSTEM 

Subject t STAND-ALONE AT NOON 

SYSTEM IS GOING DOWN AT NOON FOR NEW MONITOR TO BE LOADED ♦ 




In this case, the system prints the Messages-of-the-Day since 
June 25, 1979 on your terminal. 

When you type /MESSAGE-OF-THE-DAY after the prompt, RDMAIL 
outputs all new Messages-of-the-Day since you last logged in, 
whether or not you have read them. 
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/PERUSE - PERUSE Switch 

Type /PERUSE when you want to peruse messages in your file. Only 
the following lines for each message are printed: Date:, From:, 
To:, CC:, and Subject: /PERUSE can be combined with date/time 
input and all other program switches except /HELP. A sample 
output of /PERUSE is as follows: 


©rdmailCkD 

Date and time (/HELP for help) Apr 12* 1979 /PERUSEGID 

Date I 12 Apr 79 0900-EDT 
From: OSMAN 

To: AD LEY 


8 u b v. j e c t : w o u r f i 1 e s 


Date: 12 Apr 79 1452-EDT 

From: HARAMUNDANI S 

To: FOR AD A 

C C : A D L E Y v H ARAM U N D A N 1 8 
Subject: DUMPER 


Date: 17 Apr 79 1451-EDT 

From: LYONS 

To: AD LEY 

8 u b J e c t : R e : T E 8 T 0 F r M A 1 L P R 0 G R A M 

The system continues to output messages from April 12, 1979 to 

the present date. 

/STOP - STOP Switch 

Type /STOP to cause RDMAIL to stop after each message that it 
types. Following each message, the program prompts you to press 
RETURN for more output. /STOP can be combined with date/time 
input and all other program switches except /HELP and /LIST. A 
sample output of /STOP and /PERUSE is as follows: 

©RDMAILCeD 

D s t © a n d t i m © ( / H E L P f o r h © I p) m a a 1 r 1 979 /ST 0 P / P E R U S eQED 

Date: 1 Maw 79 1335-EDT 

From: OSMAN 

To: ADL..EY 

Subject : MAILER 

C! T w p e < C R > f o r iyi o r e “I ( ret ) 

Date: 1 Maw 79 1844-EDT 

From: LYONS 

To: ADLEY 

8 u b .j e c t : Y o u r a c c o u n t o n 8 w s t e m 2 1 1 6 
CiTwpe <CR> for mo re 3 ( RET ) 

The system continues to output messages from May 1, 1979 to the 
present date, allows you to peruse them, and stops after each 
message . 
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If you type an invalid switch in RDMAIL , you receive the following 
message : 

?Does not match switch or keyword 
The system returns with the prompt for you to type a valid switch. 


3.3 RDMAIL MESSAGES 

The most common RDMAIL messages, their descriptions, and suggested 
user responses follow. Fatal errors are preceded by a question mark 
(?) . A warning message is preceded by a percent sign (%) . 

?Day of month too large 

Description: You typed an invalid day of the month after the 

program prompt, Date and time (/HELP for help). 

Suggested User Response: Enter a valid day of month when the 
program returns with the prompt following the error message. 

?Does not match switch or keyword 

Description: You typed an invalid switch after the program 

prompt, Date and time (/HELP for help). 

Suggested User Response: Type one or more valid RDMAIL switches. 

%MAIL.TXT File contains updated entries or improper format 

Description: Your MAIL . TXT file is in the wrong format, possibly 

from being edited with a text editor. 

Suggested User Response: Copy the file so you have a record of 
any current messages. Then, delete the file. 

?Invalid date format 


Description: You made an error in the date format following the 

program prompt. Date and time (/HELP for help). This error 

differs from an invalid day of the month; the error might be, 

for example, misspelling of the month or an incorrect year. 

Suggested User Response: Type a valid date format when the 

program returns with the prompt after the error message. 

?Invalid time format 


Description: You typed an invalid time after the program prompt, 
Date and time (/HELP for help). For example, a possible error 
is a nonexistent time such as 26:00:00. 


Suggested User Response: Type a valid time when the program 
returns with the prompt after the error message. 
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?LPT: not available for output 

Description: This message appears in response to /LIST. Either 
you defined a logical name for LPT: that points to an 
unavailable device. RDMAIL ignores /LIST, and prints the mail on 
your terminal. 

Suggested User Response: Wait for the line printer to become 
available, or redefine the logical name to point to an available 
device (such as DSK:). 
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THE FILCOM PROGRAM 


4.1 INTRODUCTION 

The FILCOM program compares two files and prints any differences 
between them. With FILCOM , you can compare either ASCII files (text 
files and source programs) or binary files (relocatable binary files 
and save files) . The comparison is line by line for ASCII files, and 
word by word for binary files. 


4.2 RUNNING FILCOM 

To run FILCOM, type FILCOM, and press the RETURN key. The program 
prompts you for input with an asterisk: 

0FILCOMCHD 

* 

After the prompt, enter a FILCOM command string in the following 
format : 

Destination file spec=Source file sped, Source file spec2/Swi tches 


where : 

Destination file spec is the output file that contains the 
differences between the two Source files. 

If you do not specify a Destination filename, FILCOM uses the name of 
the file in Source file spec2. If you omit the name in Source file 
spec2, the program uses the filename from Source file spec 1. If 
there is no filename in Source file spec 1, then the filename FILCOM 
is used. The default for the Destination file type is .SCM for ASCII 
files and . BCM for binary files. If you completely omit the 
Destination file spec, FILCOM writes the output to the device TTY:. 

Source file sped is the first input file you wish to compare. 

You must completely specify this file spec in the command string. 

Source file spec2 is the second input file you wish to compare. 

If you omit the filename in Source file spec2, FILCOM uses the 
filename in Source file sped. If you omit the file type in Source 
file spec2 , FILCOM uses the file type in Source file sped. To 
indicate a null file type, simply type a period (.) at the end of the 
filename in either Source file sped or Source file spec2. 
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NOTE 

FILCOM does not accept file generation 
numbers. You can still compare two 
files with the same name and type but 
different generation numbers (for 
example, FOO.BAR.l and FOO.BAR.2) by 
defining logical names for these files. 
For more information on defining logical 
names, refer to the TOPS-2 0 User ' s 
Guide . 


You can enter switches after the two input file specs. These switches 
tell FILCOM how to compare the specified files. However, you don't 
always need to give switches, because FILCOM often determines the type 
of comparison by the file types. If either of the input files is of a 
type listed in Table 4-1, the files are compared in binary mode; 
otherwise they are compared in ASCII mode. 


Table 4-1 

Special File Types Recognized by FILCOM 



.BAC 

. DMP 

.RIM 


.BIN 

.MSB 

. RMT 


.BUG 

. OVR 

. RTB 

Pure Binary Files: 

.CAL 

. QUC 

. SFD 


. CHN 

.QUE 

.SYS 


.DAE 

.QUF 

. UFD 


. DCR 

.REL 

. XPN 

Sharable Save Files: 

.EXE 

Nonsharable Save Files: 

.LOW 

.SAV 

.SVE 

Offset Address Files; 




word 0 of the file 




treated as if it was 




word 400000. 

. HGH 

.SHR 



NOTE 

If FILCOM cannot determine the mode for comparison from 
the input file type or switches, it compares the files in 
ASCII mode. 


For more information on sharable and nonsharable save files and the 
control words used in them, refer to the TOPS-2Q Monitor Calls 
Reference Manual. 
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After you enter the command string specifying the mode for comparison, 

the two input files, and any necessary switches, press RETURN. When 
FILCOM has finished the comparison, it notifies you of the status: 

% f i 1 e s a re d :i. f f e r © ri t 

or 

N o d i f f e r e n e e s e n e o u ri t e r e d 

The program then prints a second asterisk for you to enter another 
command string. For example: 

(3FIL.COM CUD 


*C0MPAR ♦ FIL=EXFILE ♦ 1 ? EXFILE ♦ 2 C^D 
% f i 1 e s are d i f f e r e ri t 


* 

If you wish to stop the program, type CTRL/C to return to TOPS-20 
command level. 


4.2.1 Comparing ASCII Files 

In ASCII mode, FILCOM compares the characters in each line of the two 
files, always ignoring nulls. Comments and spacing can be selectively 
ignored, based on the switches you type. 

FILCOM contains eight switches that you use in the command string to 
compare ASCII files. 

/A Instructs FILCOM to compare the two input files in ASCII 

mode. It treats both files as if they contain ASCII 
characters, searches the files for text differences, and 
ignores similar lines. /A is especially useful if the input 
files are ASCII files but have one of the file types listed 
in Table 4-1. 


/B Considers blank lines in the comparison. If you do not 

specify /B in the command string, FILCOM normally ignores 
blank lines in the two files. 

/C Instructs FILCOM to ignore comments and spacing in the 

files. Comments are defined as text on a line following a 
semicolon. Spacing is defined as spaces and tabs. FILCOM 
normally considers comments and spaces in the comparison. 
This switch is useful when you compare assembly language 
source files (MACRO Assembler source files) . 

/H Prints a FILCOM help text, which contains a description of 

the program and all switches, on your terminal. You can 
type /H by itself immediately after the FILCOM prompt, or in 
a command string. 


NOTE 

/H overrides all other switches that you may combine 
with it. The system ignores all other specified 
switches in the combination, and prints the full 
FILCOM help text. 
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/nL Defines the number of lines that end a match. When FILCOM 

finds that number of successive lines that are the same in 
both input files, it prints all differences found up to the 
time of the match. The FILCOM output includes the first 
line of the match for easy reference. FILCOM normally uses 
the value "3" for the number of lines (the value of n) . 

/Q Instructs FILCOM to print only the status of the comparison 

(either ?files are different or No differences encountered) . 
FILCOM does not enumerate the differences between the files. 
It stops reading the files after it discovers the first 
difference . 

/S Ignores spaces and tabs in the comparison of two ASCII 

files. FILCOM normally considers spaces and tabs in the 
compar ison . 

/U Compares your two input files in update mode. This means 

that FILCOM creates an output file, which is the second 
input file, with change bars in the left margin next to the 
lines that differ from those in the first input file. 
Deleted lines are indicated by a change bar on the next 
common line. /U is helpful when you are comparing two 
versions of text. To obtain a meaningful comparison, type 
the latest version of the file as the second input file in 
the command string. 

The output file in ASCII mode comparison includes a header for each 
input file that contains the following information: 

® the file number 

© the file spec 

@ the date and time the input file was created. 

The following is an example of a header that would appear in an ASCII 
output file: 

F :i. l e 1 ) D S K l F 0 R L I B ♦ T X T E 4 > 2 44 1 c r e a t e d : 1 0 5 2 2 6 - J IJ L - 1 9 7 9 
File 2) DSK JFQRTEX ♦ TXTE4 y 2443 created? 1155 26-JUL-1979 


NOTE 

If you use /U in the FILCOM command 
string (compare in update mode), this 
header does not appear. 


Each time FILCOM finds differences between two ASCII input files, it 
outputs a number corresponding to the first file, and the differences. 
At the end of the list of differences, the program prints a common 
line between the two files. The program then prints four asterisks, a 
number corresponding to the second input file, and the differences. 
Then FILCOM repeats the set of differences until all the differences 
between the two files are found. A row of 14 asterisks (*) marks the 
end of a difference. 
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For example, you have two text files named FIL1.TXT and FIL2.TXT. 
the TYPE command to examine the contents of both files: 


Use 


©TYPE 

fili.txtCsID 

t h i s 

:i.s 

1 ine 

1 

t h i s 

is 

1 i ne 

2 

t h i s 

i s 

1 i ne 

3 

this 

is 

1 ine 

4 

t h :i. s 

i s 

1 ine 

5 

this 

i s 

! i ne 


this 

i s 

1 i ne 

6 

this 

is 

1 i ne 

7 

this 

is 

line 

8 

th is 

i s 

1 ine 

9 v t 

this 

is 

line 

10 

©TYPE 

FIL2.TXTC“D 

t h :i. s 

is 

1 ine 

1 

t h i s 

is 

1 ine 

2 

t h i s 

i s 

1 ine 

3 

t h i s 

is 

1. i ne 

4 

this 

i s 

1 ine 

5 * 5 

t h i s 

is 

line 

6 

t h i s 

i s 

1 ine 

7 

t h i s 

is 

1 ine 

8 

this 

is 

1 i n e 

9 

t h i s 

is 

1 ine 

10 

t h i s 

is 

1 ine 

11 

this 

is 

1 ine 

12 

t h i s 

i s 

1 ine 

13 

th is 

is 

1 ine 

1 4 9 w 


is a comment 


which is the end « 


© 


Run FILCOM to compare these files and name the output file DIFFER. SCM. 
Type the following: 

0FILCO MGeD 

♦ DIFFER ♦ SCM-FILl ♦ TXT 9 FIL2 ♦ TXTC*£l) 

% f i 1 e s are d i f f e r e n t 


♦ 
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The program informs you that the files are different, and then gives 
you the asterisk prompt for more input. To see the differences that 
FILCOM found between the two files, return to TOPS-20 command level 
(type CTRL/C) and use the TYPE command. 


% f i 1 e s are d :i. f f e r e n t 

G TRL/c) 

6 TYPE DIFFER* SCMQeD 

F r I L E 1 ) D S K J F I L 1 ♦ T X T C 4 y 6 7 II 

File 2) DSK:FIL2*TXTC4»673 


c r e a f e d : 1 2 1 2 2 5 - ,J u 1 - 1 9 7 9 

c r e a t e d : 1 6 1 6 2 5 - J u 1 - 1 9 7 9 


1)1 

th is 

i s 

3. ine 

1 ) 

t h i s 

is 

1 ine 

%%%% 

2 ) 1 

th i s 

is 

3. ine 

\l / \l/ \1/ \l/ \1/ %!/ \L* \l/ v|/ vl/ \1/ \l/ \1/ \l/ 


1 ) 1 

this 

is 

1 ine 

1 ) 

this 

is 

1 ine 

*>K>K>K 

2 ) 1 

this 

:i. s 

3. ine 

2) 

this 

is 

3. ine 

2) 

t h i <:> 

is 

3. ine 

2) 

this 

i <:> 

1 ine 

2) 

th is 

is 

1 ine 

2) 

this 

i s 

1 ine 


^ ^ W W vV ^ ^ 

/|\ /|\ /|\ /p /f\ /p /p /p /p /p /p 

e 


9 y this is a comment 

10 

9 

10 
11 
12 
13 

14 y which is the end* 


The output shows the differences between the two files. Line 5 was 
deleted, line 9 was changed, and lines 11-14 were inserted. The two 
blank lines in FIL2.TXT are ignored, because /B was not specified in 
the command string. The number "1" that appears beside 1) and 2) in 
the output is the page number of the file where the differences were 
found. Text pages are delimited by formfeeds. 

Now, compare FIL1.TXT and FIL2.TXT using /C in the command string. 


BFILCQM C^T) 


*TTY : =F IL 1 ♦ TXT y FIL2 ♦ TXT/CC^D 
F i 1 e 1 ) DSK t F I L 1 ♦ TXT C 4 y 67 1 
File 2) DSK ♦ FIL2 ♦ TXT £4 y 67 "I 


c r e a t e d $ 1 2 1 2 2 5 - J u 3. - 1 9 7 9 

c r e a t e d ♦ 1 6 1 6 2 5 - J u 3. - 1 9 7 9 


1 ) 1 

this 

i s 

1 ine 

5 

1 ) 

this 

i s 

3. ine 

\.t ♦ >.j 

2)1 this is 

^\^\/p/p^\/p>p/p/pq\/p/p/p/p 

1 ine 

5*5 

2 ) 1 

this 

i s 

3. ine 

11 

2 ) 1 

th is 

i s 

3. ine 

12 

2 ) 1 

this 

is 

3. ine 

13 

2)1 

thi s 

i s 

1 ine 

1 4 y 


% f i 3. c s a r e d i f f e r e ri t 

* 


The output is different because /C causes FILCOM to ignore comments 
and spacing in the files. 
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Using the same two text files, now compare them in update mode, and 
write the output to the device TTY: (your terminal). Because 
FIL2.TXT is the latest version of the two text files, type it as the 
second input file in the command string. The command string is: 


@ FILCOM QeD 

* T TY ♦ =- F I L 1 ♦ TXT y FIL2 ♦ TXT / U ( ZeD 


this is line 
this is line 
this is line 
t h i s :i. s 1 i n e 
this is line 
this is line 
this is line 


! this is line 

! this is line 

! this is line 

! this is line 

1 this is line 

! this is line 

! this is line 

% f i 1 e s a r e d i f f e r e n t 


1 

p 

3 

A 

5 

6 
7 


B 

9 

1 0 
1 . 1 . 

1.2 

1.3 

14 v which is the end* 


* 

As mentioned previously, in update mode comparisons, the output file 
is the second input file (latest version) with change bars inserted 
next to the differences found between the two files. The example 
above shows such an output file. Note that the program also types the 
"%files are different" status on your terminal. Following this, 
FILCOM gives another prompt for another command string. 


4.2.2 Comparing Binary Files 

FILCOM automatically determines that a file is binary if it has one of 
the file types listed in Table 4-1. 

Sharable and nonsharable save files represent the location of data in 
memory. In FILCOM, expanding the files before comparing them means to 
compare the data as it would appear if the files were loaded into 
memory. Comparing the files without expanding them means to compare 
each word in the files regardless of the usual meaning of the files' 
control words. 

You can list a binary file with FILCOM. To do this, simply omit the 
comma and the second input file spec in the command string. 
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FILCOM contains seven switches that you use in the command string to 
compare binary files. Switches control what part of the binary file 
you see. 

/E Forces FILCOM to consider both input files as sharable save 

files regardless of the file types given. Normally, FILCOM 
selects its comparison according to the file types of the 
files . 

/H Prints the FILCOM help text. Refer to the description of /H 

in Section 4.2.1. 

/nL Compares a binary file starting at word "n". The number "n" 

is an octal number. Refer to /nU, below. 

/Q Instructs FILCOM to print only the status of the comparison. 

It does not list the actual differences, and causes FILCOM 
to stop reading the files after it discovers the first 
difference. Refer to the description of this switch in 
Section 4.2.1. 

/nU Compares a binary file up through word "n". The value "n" 

is an octal number as in /nL. If you combine /nU with /nL 
in the command string, the input files are compared only 
within these limits. 

/W Compares two binary files that have nonstandard file types. 

(Refer to Table 4-1.) The files are not expanded before 
FILCOM compares them. /W compares the files' internal 
control words in addition to data, reading the files one 
word at a time. 

/X ^ Instructs FILCOM to expand nonsharable save files before 

comparing them in binary mode. The program ignores control 
words and compares only the code in the files. 

All FILCOM binary switches apply when you dump a file. Expanding a 
file shows how it would appear in memory. Dumping a file without 
expanding it shows the file's internal format. 

The output file of a binary mode comparison contains the same header 
as output files for ASCII comparisons. (Refer to Section 4.2.1.) 
However, the comparison differs because it is done word by word. If 
the left halves of the two words being compared are the same, FILCOM 
prints the absolute difference between the two words. Otherwise, 
FILCOM prints the logical exclusive OR (XOR) . 
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For example, you want to compare two binary files. They are FIL3.BIN 
and FIL4.BIN. First you use FILCOM to dump them and examine their 
contents. The output is written to the device TTY: (your terminal): 

id FILCOM flip 

*tty:=fil3*binC«D 

000000 201400 000000 

000001 202400 000000 

000002 202600 000000 
000003 203400 000000 

000004 203500 000000 

000005 203600 000000 

000006 203700 000000 

000007 204400 000000 

000010 204440 000000 

000011 204500 000000 

% f i 1 e s a r e d :i. f f e r v e n t 

*tty:-fil4,bj:n<S 

000000 201400 000000 

0 0 0 0 0 1 2 0 2 4 0 0 0 0 0 0 0 0 

0 0 0 0 0 2 2 0 2 6 0 0 0 0 0 0 0 0 
000003 203400 000000 

000004 203540 000000 

0 0 0 0 0 5 2 0 3 6 0 0 0 0 0 0 0 0 

0 0 0 0 0 6 2 0370 0 0 0 0 0 0 0 

000007 204420 000000 

000010 204440 000000 

000011 204500 000000 

% f i 1 e s a r e d :i. f f e r e n t 

* 

Now compare the files. Note that since both file types are .BIN, the 
program automatically compares them in binary mode without you 
specifying any switches. Again, the output is written to your 
terminal : 

(» FILC0MCED 

* TT Y : =F I L 3 ♦ B I N * F I L4 ♦ B I NQiD 

File 1) D8K ♦ F I L3 ♦ B I N £ 4 y 67 3 created: 1419 10~Sep~1979 

File 2) BSK ♦ F I L4 ♦ B I N C 4 * 67 D created: 1419 10-Sep-1979 

000004 203500 000000 203540 000000 000040 000000 

000007 204400 000000 204420 000000 000020 000000 

% f i 1 e s a r e d i f f e r' e n t 

* 

Compare the files once more, but specify a quick comparison (/Q) in 
the command string. This causes FILCOM to merely report the status of 
the comparison. If there are differences, the status message prints 
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with a question mark, ?, instead of a percent sign, %, for error 
detection jobs. (Refer to Section 4.4, FILCOM Messages.) The command 
string for this comparison is as follows: 


(»F ILCOMTiiT) 


*TTY: ^ F I L 3 ♦ B I N y F I L 4 ♦ B I N / GC ED 

File 1 ) DSK J FI L3.BINC 4 y 67 3 created: 1419 lO-Sep-1979 

File 2) DSK :FIL4*BINC4» 673 created: 1419 10- '-Sep- 1979 

? f i 1 e s a r e d i f f e r e n t 

* 

Do a third comparison of these two files, but now restrict the range 
with /nU and /nL: 


gFILCQMfiiT) 


* T T Y : » F I L 3 ♦ B I N > F I L 4 ♦ BIN/5L/6 U QID 
No d i f f e r e n e e ir> e ri c o u n t e r e d 

In the following example, you are comparing two executable files, 
FILCOM automatically expands them because of the .EXE file type: 

gfilcomgID 

* T T Y : * F I L 1 ♦ EXE r F I L 2 ♦ E X E («D 
F i 1 e 1 ) D S K l F I L 1 ♦ E X E C 4 > 6 7 3 
F i 1 e 2 ) Ii S K t F I L 2 ♦ E XE 14 y 6 7 3 


created t 
created ♦ 


1426 

1427 


10- Sep- 1979 
10 -Sep- 1979 


000141 600000 000000 

002112 000004 015062 

% f i 1 e % a r e d i f f e r e n t 


255000 000000 
000004 015063 


455000 000000 
000001 


In this last example, you compare both .EXE files without expanding 
them first. Any differences that exist in the files* internal 
directory pages appear in the output. The command string for this 
comparison is as follows: 


©FILCOMCsi 


* ' T T Y : « F I L. 1 ♦ EXE y F I L 2 ♦ EXE/U CE D 


File 1) 

DSK : FI LI ♦EXEC 4 

y 6 7 3 

create 

d: 1426 

10-Sep- 

File 2) 

DSK:FIL2*EXEC4 

y 673 

crea te 

d: 1427 

10-Sep- 

000000 

00 1776 

000003 

001776 

000007 


000004 

000002 

002000 

000000 

000000 

000000 

002000 

000000 

000003 

001775 

000003 

000000 

000002 

001775 

000001 

000004 

000000 

254000 

000000 

00000 1 


253777 

000005 

000000 

000140 

300000 

000003 

300000 

000143 

000006 

001777 

000001 

000000 

000002 

001777 

000003 

000007 

000000 

000000 

001775 

000003 

001775 

000003 

000010 

000000 

000000 

000000 

254000 


254000 

000011 

000000 

000000 

000000 

000140 


000140 

000012 

000000 

000000 

001777 

00000 1 

001777 

000001 

001141 

600000 

000000 

255000 

000000 

455000 

000000 

003112 

000004 

0 15062 

000004 

015063 


000001 


1979 

1979 


% f i 1 e s a r e d i f f e r v e n t 
>K 
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4.3 FILCOM SWITCHES 

Table 4-2 contains all the FILCOM switches in alphabetical order. It 
also lists the mode of comparison and description for each switch. 


Table 4-2 
FILCOM Switches 


Switch 

Comparison 

Description 

/A 

ASCII 

Compares files in ASCII mode 

/B 

ASCII 

Considers blank lines in the 
comparison 

/c 

ASCII 

Ignores comments and spacing 
in MACRO source files 

/E 

Binary 

Considers both files as 

sharable save files 

/H 

ASCII& 

Binary 

Prints the FILCOM help text 

/nL 

ASCII& 

Binary 

Defines the number of lines 
that end a match in ASCII 
comparisons; determines the 

lower limit where a partial 
comparison begins in binary 
comparisons 

/nU 

Binary 

Determines the upper limit 
where a partial binary 
comparison stops 

/Q 

ASCII& 

Binary 

Prints only the status of the 
comparison; does not 
enumerate the differences 

/s 

ASCII 

Ignores spacing and tabs in 
the comparison 

/u 

ASCII 

Compares the files in update 
mode and inserts change bars 
next to the differences 

/w 

Binary 

Compares binary files with 
nonstandard file types, 
ignoring control words (if 
any) 

/X 

Binary 

Expands nonsharable save files 
before comparing them 
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4.4 FILCOM MESSAGES 

Some of the messages printed by FILCOM contain information that is 
dependent on the exact command string, switch, or file you specified. 
The key to these message variables follows: 

[device] A device name. 

[file] A file spec. 

[n] A designator for the first or second input file. 

[reason] The reason for a file access failure. These are 

listed in Table 4-3 at the end of this section. 

The most common FILCOM messages are listed below alphabetically. They 
are all fatal errors because they are preceded by a question mark (?). 

?Buffer capacity exceeded and no core available 

Description: You attempted to compare two text files with a 

difference so large that FILCOM cannot obtain enough memory to 
store the differences. 

Suggested User Response: Check that you are comparing two files 
that are reasonably similar; or, use /nL with n larger than the 
value 3. 

PCommand Error 

Description: You typed an invalid command, such as an undefined 

switch or an improperly formatted file spec. 

Suggested User Response: Retype the correct command syntax. 
PDevice [device] Not available 

Description: The device you specified is not available. In 

other words, someone may be using it, or there may be no such 
device on your system. 

Suggested User Response: Specify a device available to you. 

?FILE [n] NOT IN CORRECT EXE FORMAT 

Description: The first or second input file in the command 

string is not a correctly formatted sharable save file (.EXE file 
type) . You may have specified a file that is in nonsharable save 
file format (a result of the TOPS-20 CSAVE command, rather than 
the SAVE command) . 

Suggested User Response: Do not use nonsharable save files. 
They are less efficient than regular sharable save files. Bring 
the program into memory with the TOPS-20 GET command, save it 
again with the SAVE command, and then reissue the commands. You 
can also look at the files as nonsharable save files or pure 
binary files. 

?File [n] not in SAV format 

Description: Your first or second input file is not in proper 

nonsharable save file format. 

Suggested User Response: Specify the correct file or look at the 
files as sharable save files or pure binary files. 
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?File [n] read error 

Description: Your first or second input file contains an error. 

Suggested User Response: Try the operation again. If it still 
fails, ask the operator to check the device for errors. 

?Input error for input file [n]- [file] [reason] 

Description: FILCOM could not access your first or second input 

file for the reason specified. (Refer to Table 4-3 for the exact 
reason . ) 

Suggested User Response: The particular reason in Table 4-3 
gives corrective action. 

?NOT ENOUGH CORE AVAILABLE TO HOLD DIRECTORY 

Description: FILCOM is attempting to compare your sharable save 
files, but cannot get enough memory to hold the file's internal 
directory . 

Suggested User Response: Re-create the .EXE file. If the error 
persists, contact your Software Specialist, or send a Software 
Performance Report (SPR) to DIGITAL. 

? Output device error 

Description: FILCOM received an error while writing your file. 

Suggested User Response: The device may be faulty. If the 
problem persists, contact your operator to fix the problem. 

?Output device error- [device] cannot do output 

Description: You specified a device that is unable to do output, 

such as a card reader. 

Suggested User Response: Specify a device that is capable of 
producing output. 

?Output ENTER error for [file] [reason] 

Description: FILCOM is unable to write the file for the reason 

specified . 

Suggested User Response: Refer to Table 4-3 for corrective 
action that applies to the reason for the error. 

Table 4-3 contains the various reasons for file access errors that can 
appear in FILCOM messages. 
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Table 4-3 

Reasons for File Access Errors 


(0) 

File not found 



You specified a file that does not exist, 
existing file. 

Specify an 

(1) 

Nonexistent UFD 



You specified a directory that does not exist, 
existing directory. 

Specify an 

(2) 

Protection failure 



You do not have sufficient privileges to access 
file. Negotiate the needed privileges with 

operator or the owner of the file. 

the named 
the system 

(3) 

File being modified 



Another job is currently modifying the named file 
access the file at another time or use a different 

Try to 
filename. 

(14) 

No room or quota exceeded 



You exceeded the quota of the named directory or the entire 
capacity of the named file structure. Delete and expunge 
some of your files, or specify a directory or structure with 
sufficient space. 

(15) 

Write-lock error 



You requested an output file on a write-locked device, such 
as a magnetic tape. Either write-enable the device and try 
again, or specify another device. 
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5 . 1 INTRODUCTION 

The CREF program generates cross-reference listings from • CRF files. 
You produce .CRF files with LOAD-class commands. (Refer to the 
TOPS-2Q Commands Reference Manual .) A cross-reference listing is one 
that contains your source program (from either the ALGOL or FORTRAN 
compiler s , or the MACRO assembler) plus a list of all the symbols used 
and the line numbers on which they are used. As such, the CREF 
program is a helpful tool for debugging and modifying programs written 
in these languages. 


NOTE 

You do not need to run CREF for COBOL 
programs. The COBOL compiler 
automatically generates CREF listings. 


5.2 RUNNING CREF 

Because CREF reads only .CRF format files, you must first create these 
files before you run CREF. These files are created when your program 
is compiled. Section 5.2.1 describes how to create .CRF files. 

Once you create .CRF files, you can run CREF to produce 
cross-reference listings. Section 5.2.2 describes how to run CREF. 


5.2.1 Creating .CRF Files with COMPILE 

To create a .CRF file, you must compile your program. To do this, 
type COMPILE after the TOPS-20 prompt @, followed by /CREF and the 
name of the program you want to compile; then press the RETURN key. 
After you press RETURN, the system compiles your program and then 
returns you to TOPS-20 command level. For example: 

©COMPILE /CREF' BE + MAC C^O 
MACRO t BE 

EXIT 

© 
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Compiling a program does not automatically create a .CRF file. This 
is why you specify /CREF in the command string. For more information 
on the COMPILE command, refer to the TQPS-20 Commands Reference 
Manual . 

You can create .CRF files of two programs in the same command string. 
For example: 

C 0 M P I L E / C R E F BE ♦ MA C y C R E F A ♦ M A C f^D 
MACRO? BE 
macro: CREF A 


EXIT 

0 

Note that this one command string is equivalent to creating .CRF files 
of both programs separately, as in the example below: 

0 C 0 M P I L E / C E E F B E . M A C<jreT) 

macro: BE 

EXIT 

6 C 0 M P I L E / C R E F C R EFA ♦ MA CCmD 

macro: CREF A 

EX I T 
6 

If your program has already been compiled, the above procedure will 
not^ work. You will immediately return to TOPS-20 command level after 
typing the command string. To create a .CRF file of an already 
compiled program, you must recompile the program. Type the COMPILE 
command followed by /COMPILE, /CREF, the program name, and press 
RETURN. For example: 

0 GOMPILE/COMPILE/CREF BE ♦ MAC 

macro: be 

EXIT 

0 


5.2.2 Producing Cross-Reference Listings 

Once you create a .CRF file, you can run CREF to generate the actual 
cross-reference listing. There are four types of tables that you can 
get in these listings. The four types of tables are: 

• Regular Symbols - This table contains user-defined symbols, 
labels, address tags, and assignments. 

• OPDEF and Macro Names - This table contains user-defined 
operators such as macro calls and OPDEFs. 

• Op Codes - This table contains hardware machine mnemonics and 
assembler pseudo-ops, such as MOVE and XALL . 

• Procedure Nesting Levels - This table contains the names of 
procedures and numbers of blocks, indented to show their 
nesting in the program. Only the ALGOL compiler generates 
this table in a CREF listing. 
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You produce cross-reference listings by running CREF and giving a 
command string with switches to specify the type of listing you 
desire. The general command string format is: 


Destination file 
spec2/Switches. . . 


spec=Source file specl/Swi tches , Source file 


where: 

Destination file spec is the output file that contains the 
cross-reference listing. 

If you omit the device and the filename in the Destination file spec, 
CREF uses the device LPT:. If you omit the device but do specify a 
filename, CREF uses the device DSK : . If you do not specify a filename 
in the Destination file spec, CREF uses the filename in Source file 
sped. If you do not specify a file type in the Destination file 
spec, CREF uses the type . LST . If you omit the equal sign (=) in the 
command string, CREF uses all defaults for the Destination file spec 
(you only specify the Source file specs) . 

Source file sped, Source file spec2...are the input files. These 
are the .CRF files you produced from compiling your programs. 

If you omit the device in any of the Source file specs, CREF uses the 
device DSK:. If you omit a filename in any Source file spec, CREF 
uses the filename CREF. If you omit a file type in any Source file 
spec, CREF uses the file type .CRF, then .LST, . TMP , and null. 

If you omit a PPN or a logical name for a PPN in either the 
Destination file spec or any of the Source file specs, CREF assumes 
that you mean your connected directory. 


As mentioned, you can type CREF program switches in the command string 
after each input file spec. These switches and their functions are 
described in Table 5-1. 
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Table 5-1 

CREF Switch Options 


Switch 

Function 

/A 

Advances magnetic tape reel by one file. 
You can type this switch more than once in 
the command string. 

/B 

Backspaces magnetic tape reel by one file. 
You can type this switch more than once in 
the command string. 

/c 

Cancels the processing of any switches in 
your SWITCH . INI file. 

/D 

Restores the processing of any default 
switches in your SWITCH.INI file. 

/H 

Types the CREF help file. /H is illegal in 
a SWITCH.INI file. 

/K 

Suppresses Regular Symbol Table in the CREF 
listing. 

/M 

Suppresses OPDEF/Macro Table in the CREF 
listing. 

/o 

Includes the Op Code Table in the CREF 
listing . 

/P 

Preserves an input file with the file type 
. CRF or . LST. These types of input files 
are normally deleted. 

/R 

Requests the line number at which the CREF 
listing is to start. CREF types out 
"RESTART LISTING AT LINE:", after which you 
type the line number and press RETURN. If 
you use an indirect file, CREF looks for 
the number in the indirect file. /R is 
most useful for physical (non-spooled) line 
printers, and is illegal in a SWITCH.INI 
file. 

/s 

Suppresses the program listing and lists 
only the tables you select. 

/T 

Skips to the logical end of the magnetic 
tape . 

/ W 

Rewinds the magnetic tape. 

/z 

Zeroes the DECtape directory. This is a 
historical switch, and is illegal. 
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If you always want to use specific switches when you run CREF , you can 
put these switches in a SWITCH.INI file. Then, each time you run 
CREF, it automatically reads these switches from the SWITCH.INI file. 
You can use all CREF switches in your SWITCH.INI file except /H and 
/R. For more information on creating a SWITCH.INI file, refer to the 
TOPS-2Q User 1 s Guide . 

You can use an indirect file in CREF to reference a file within a 
command string. The indirect file can contain a complete or partial 
CREF command string (filenames and switches) . For more information on 
using indirect files, refer to the TOPS-20 User's Guide . 

You can produce cross-reference listings by typing CREF as a command 
or as a program name after the TOPS-20 prompt @. To run CREF as a 
command, type CREF after the TOPS-20 prompt @ and press RETURN. This 
causes CREF to produce a cross-reference listing of any .CRF files you 
created in that particular terminal session. For example, if you 
create .CRF files for BE. MAC and CREFA . MAC and then run CREF, type the 
following : 


CREF C ret ) 

CREF ♦ BE 
CREF ♦ CREFA 
0 

Because you did not specify a switch, the default is for CREF to give 
you a cross-reference listing that contains a Regular Symbols Table 
and an OPDEF/Mac ro Table for each of the two .CRF files. If you only 
specify switches with this format, these switches apply to all files 
CREF processes. If one of your CRF files is an ALGOL program, the 
listing also includes the Procedure Nesting Level Table. 

If you create .CRF files for several programs, but want a 
cross-reference listing of just one file, type CREF after the TOPS-20 
prompt @ followed by a CREF command string. For example, you have 
.CRF files for BE. MAC and CREFA. MAC, but you only want a 
cross-reference listing for BE. MAC. Type the following: 

(3 CREF BE ♦ LSI -BE ♦ CRF/Sw i tchQED 

CREF ♦ BE 
(3 

This command string causes CREF to produce a cross-reference listing 
for BE. MAC that includes any tables you specify with the switch. 

To run CREF as a program, type R CREF after the TOPS-20 prompt @ and 
press RETURN. The program prompts you with an asterisk. Now type a 
CREF command string. For example, you create a .CRF file for BE. MAC 
and then run CREF as a program, specifying /0 in the command string. 
Type the following: 

(3R CREFQeT) 

* BE ♦ LST =BE/OQeT) 

CCRFXKC 5K CORE 3 

* 

This command string causes CREF to produce an cross-reference listing 
for BE. MAC that contains a Regular Symbols Table, an OPDEF/Mac ro 
Table, and the Op Code Table (/0 appears in the command string) . 
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NOTE 

For an explanation of the program 
message in square brackets that appears 
in the last example, refer to Section 
5.5, CREF Messages. 


You can also run other programs from CREF. To do this, type R CREF 
after the TOPS-20 prompt @ and press RETURN. After the asterisk 
prompt, type the filespec for the second program you wish to run, then 
type an exclamation point (!) and press RETURN. 


5.3 CREF EXAMPLES 

First, type your SWITCH.INI file to see that /0 is included for CREF. 
Then define the logical name LPT: so that the CREF output goes to the 
disk, where you can type it. Without the logical name, the output is 
spooled to the line printer. 

@ TYPE SWITCH* I NlQSQ 
C REF/0 

RUNOFF/CRETURN/MESSAGE t ( NOPREFIX , FIRST ) 

MAKL IB/MESSAGE X ( NO PREFIX* FIRST ) 

6 DEFINE LPTS PSKtf^D 
0 

Now, compile a MACRO assembler program and request a CREF listing. 
Process MACRO'S listing file with CREF to get the final listing. Note 
that because of the /0 on the CREF line in SWITCH.INI, CREF 
automatically includes the Opcode Table. 
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@CQMPI L E / C 0 M P I L E / C R E F C E E F A dD 
MACRO: CREFA 


EXIT 

pCREF C «t ) 


CREF : 

CREFA 




pTYPE i 

CREF A ♦ !„ ST f^D 




L CREFA 

CREF Example 

MACRO %53A ( 1 152 ) 10J39 

10-Sep- 

79 Pade 1 

CREFA 

MAC 11-JuI- 

-79 11*54 Show What CREF 

Does 

1 



TITLE 

CREFA CREF E: 

2 



SUBTTL 

Show What CREF 

3 





4 



SEARCH 

MACSYM v MONSYM 

5 



SALL 


6 



NGSYM 


7 

8 


000000 

T 0=0 


9 


000016 

L=1 6 


10 


000017 

P =17 


11 





12 


000017 

CONST- 

17 

13 



ENTRY 

TIMES ♦ 

14 





15 

000000' 201 00 

0 00 000017 TIMES ♦ * 

MOUX 

TO y CONST 

16 

000001' 220 00 

1 16 000000 

IMUL 

TO f 0 ( L ) 

17 

000002' 263 17 

0 00 000000 

RET 


18 





19 



END 



NO ERRORS DETECTED 


PROGRAM BREAK IS 000003 
CPU TIME USED 00 t 00 *872 

67 P CORE USED 


"L CONST 

12# 

15 


L 

9# 

16 


P 

10# 



TO 

st- 

1 5 

16 

TIMES* 

is 

15# ’ 


♦ ♦ MX1 

15# 

15 

16 

♦ ♦ MX2 

15# 

16 


♦PSECT 

15 

16 



"L.MOUX .15 

RET 17 


'•'LEND 

ENTRY 

IFDEF 

IFE 

IFNDEF 

IMUL 


19 

13 

15 

1 5 1 6 

16 
16 


MOUEI 

NOSYM 

PURGE 

SALE 

SEARCH 

SUBTTL 

TITLE 

♦ IF 

♦ IFN 
♦PSECT 

e 


15 
6 

16 
5 
4 
2 
1 

15 

15 

15 


16 
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Now, compile a FORTRAN program. Generate the CREF listing and type the 
result . 


©COM PILE/COM PILE/C REF CREFBGlD 

fortran: crefb 

TIMES 

©crefC «D 
cref: 

@ TYPE CREFB ♦LSTQID 

"'LTIMES CREFB ♦ FOR FORTRAN U.5A<621) /KI/C 10--SEP-79 10J39 PAGE 1 


OOOOl 


FUNCTION TIMES (ARG) 

00002 

00003 


PARAMETER CONST =17 

00004 


INTEGER TIMESy ARG 

00005 

00006 

10 

TIMES = CONST*ARG 

00007 


RETURN 

00008 

00009 


END 


SUBPROGRAMS CALLED 


SCALARS AND ARRAYS C - * B NO EXPLICIT DEFINITION - NOT REFERENCED 1 

TIMES 1 ARG 2 

TEMPORARIES 


~l.ARG 

1# 

4* 

6 

CONST 

3* 

6 


TIMES 

1# 

4# 

6# 

10P 

6* 



TIMES 

C NO ERRORS 

DETECTED 

1 


0 
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Finally, compile an ALGOL program. Generate the CREF listing as 

before and type the result. Note the Procedure Nesting Table. 

0 COMPILE/COMPILE/CREF CREFCQID 
ALGOL: CREFC 

EXIT 

0 CREF f^D 

cref: 

0 TYPE CREFC ♦LST fTiT) 

DECsystem 10 ALG0L-6()y Version 6A(654) 10-SEP-79 10J39J35 

Command string} CREFC >CREFC/C=M JSC J CREFC .ALG 


1 

000005 B1 


1 

BEGIN REAL Xy Yi 

2 

000005 


2 


3 

000012 


3 

REAL PROCEDURE SQUAREROOT ( X r L ) i 

4 

000012 


4 


5 

000016 


5 

VALUE Xy REAL Xy LABEL Li 

6 

000016 


6 


7 

000021 B2 


7 

BEGIN REAL Yy Zy 

8 

000025 


8 

IF X < 0 THEN GOTO Li 

9 

000027 


9 

Y t= (1 + X ) /2 y 

10 

000043 


10 

it: z := (x/y + y>/25 

11 

000060 


11 

IF ABS ( Z - Y) < 1&-. 

12 

000063 


12 

Y := Z? GOTO I T y 

13 

000074 


13 

ok: squareroot := zi 

14 

000076 

E2 

14 

END y 

15 

000076 


15 


16 

000115 


16 

NG: WRITE < "Number please? ")i BREAK 

17 

000117 


17 

READ ( X ) y 

18 

000122 


18 

Y := SQUAREROOT < Xy NG ) i 

19 

000127 


19 

WRITE (“The sauare root of ")y 

20 

000132 


20 

PRINT (X) y 

21 

000135 


21 

WRITE <" is “ ) y 


000140 


22 

PRINT < Y ) 5 

23 

000143 


23 

BREAK ♦ OUTPUT y 

24 

000145 

El 

24 

END 5 


NO ERRORS 





"LE 1 


PROGRAM 


B 1 


1 


B 

—2 

7 


E — 

— 2 

14 


E 1 


24 


"'LABS 

1 1 



BREAKOUTPUT 

16 

23 


IT 

10# 

12 


L 

3# 

5# 

8 

NG 

16# 

18 


OK 

11 

13# 


PRINT 

20 

22 


READ 

SQUAREROOT 

17 




3# 

13 

18 

WRITE 

16 

19 

21 

X 

1# 

3# 

5# 

Y 

1* 

7# 

9 

Z 

7# 

10 

11 


0 


17 18 20 

18 22 
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5.4 CREF MESSAGES 

The messages printed by CREF fall into three general categories: 
informational messages, warning messages, and fatal errors. 
Informational messages are enclosed in square brackets [ ] , and 
merely inform you of CREF ' s progress in processing your file. Warning 
messages are preceded by a percent sign (%) and indicate that 
something unexpected occurred, but that CREF was able to recover. In 
this case, verify that your output is correct. Fatal errors are 
preceded by a question mark (?), and indicate an occurrence that CREF 
could not handle. In this case, CREF aborts its operation. You must 
fix the problem before reissuing your command string. The % and the ? 
preceding the message are easily detected in Batch jobs. 

Some of the messages contain variable information that is dependent on 
the exact command string, switch, or file you specified. These 
variables are as follows: 


[ access] 


[device] 

[file] 

[memory] 

[status] 


[switch] 


An octal code associated with a file access 
failure. For possible access failures, refer 
to Table 5-2 at the end of this section. 

A device name. 

A file spec. 

A memory size, such as 30K. 

An octal code associated with a read or write 
error while processing a file. The meaning 
of this code is described in Table 5-3 at the 
end of this section. 

A switch name. 


The most common CREF messages are listed below alphabetically. 
?CRFCDN Can't get command file device [device] 


Description: CREF cannot 

indirect file command. 

access the 

named device 

in your 

Suggested User Response: 
device . 

Specify an 

existing or 

available 


7CRFCEF Cannot ENTER file, [access] [file] 

Description: CREF could not create the specified file for the 
reason associated with the printed access code. (Refer to Table 


Suggested User Response: Refer to Table 5-2 for corrective 
action that applies to the reason for the error. 

7CRFCFE Command file INPUT error, [status] [file] 

Description: An input error occurred reading the named command 

file. For the meaning of the specified status code, refer to 
Table 5-3. 


Suggested User Response: Refer to Table 5-3 for corrective 
action that applies to the reason for the error. 
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7CRFCFF Cannot find file, [access] [file] 

Description: CREF cannot find the specified file for the reason 

associated with the printed access code. (Refer to Table 5-2.) 

Suggested User Response: Refer to Table 5-2 for corrective 

action that applies to the reason for the error. 

7CRFCFI Cannot find input file, [file] 

Description: CREF cannot find the specified file. The reason 

can be any of those listed in Table 5-2. 

Suggested User Response: Refer to Table 5-2 for corrective 

action that applies to the reason for the error. 

7CRFCLC Can't LOOKUP command file [access] [file] 

Description: CREF cannot find the specified command file for the 

reason associated with the printed access code. (Refer to Table 
5-2.) 

Suggested User Response: Refer to Table 5-2 for corrective 

action that applies to the reason for the error. 

7CRFCME Command error - type /H for help 

Description: You typed an invalid command. 

Suggested User Response: Retype the correct command or type /H 
for help. 

7CRFDNA Device not available, [file] 

Description: You specified a device in the file specification 
that is not available to your job. It may be in use by another 
job . 

Suggested User Response: Specify a device that is available to 
your job. 

7CRFIBP Input buffer size phase error - 0 [file] 

Description: The size of the buffer area set up by the system is 

larger than the size expected by CREF. 

Suggested User Response: This is an internal error, and not 
expected to happen. If it does, contact your Software Specialist 
or send a Software Performance Report (SPR) to DIGITAL. 

%CRFIDC Improper input data at line [decimal], continuing 

Description: CREF detected incorrect data in your input file. 

This is most likely a problem with the compiler that generated 
the CREF input file. 

Suggested User Response: First, be sure that you are processing 
a valid CREF input file. If so, this is an internal error, and 
not expected to happen. Try to re-create the . CRF file, since 
the data in the original one may have been corrupted. If the 
problem persists, contact your Software Specialist or send a 
Software Performance Report (SPR) to DIGITAL. 
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?CRFIMA Insufficient memory available 

Description: Your input file is too large for CREF to handle. 

Suggested User Response: Divide your program into smaller files 
and try again. 

7CRFINE INPUT error, [status] [file] 

Description: An input error occurred reading the named file. 
For the meaning of the specified status code, refer to Table 5-3. 

Suggested User Response: Refer to Table 5-3 for corrective 

action that applies to the reason for the error. 

7CRF0UE OUTPUT error, [status] [file] 

Description: An output error occurred writing the named file. 
For the meaning of the specified status code, refer to Table 5-3. 

Suggested User Response: Refer to Table 5-3 for corrective 

action that applies to the reason for the error. 

%CRFPUE Please use ,, = " rather than " " 

Description: Older versions of CREF allowed only the use of an 

underbar ("") to separate the input files from the output file. 
CREF currently allows either "=" or but it is preferable for 

you to use CREF acts as if you typed "=" . 

Suggested User Response: Use "=" in the future. 

%CRFRLL Restart listing at line: 

Description: You specified /R to continue a listing. CREF is 

requesting the line number of the line to resume printing. 

Suggested User Response: Type the desired line number. 

%CRFS IH "/H" or "/R” switch illegal in SWITCH.INI defaulting 

Description: You specified /H or /R illegally in the CREF line 

in your SWITCH.INI file. CREF ignores these switches. 

Suggested User Response: Remove /H or /R from your SWITCH.INI 
file. 

%CRFS I I Syntax error in SWITCH.INI defaults 

Description: The CREF commands in your SWITCH.INI file are 
invalid. CREF ignores them. 

Suggested User Response: Correct the invalid switches in your 
SWITCH.INI file. 

7CRFSI0 I/O error while reading SWITCH.INI 

Description: An input error occurred reading SWITCH.INI switch 

defaults. The reason for the failure can be any of those listed 
in Table 5-3. 

Suggested User Response: Refer to Table 5-3 for corrective 
action that applies to the reason for the error. 
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?CRFUKS Unknown switch "[switch]" {in DSK : SWITCH . INI } 

Description: You specified a nonexistent switch. 

Suggested User Response: Respecify the command string with a 
valid switch, or fix your SWITCH.INI file. 

[CRFXKC [memory] core] 

Description: CREF finished its processing, and is informing you 

how much memory it used to process your CREF file. 


The octal codes listed in Table 5-2 appear in various CREF error 
messages, wherever [access] is used. The explanation beside each 
octal code describes the reason for the failure. Appropriate 
corrective action for each failure follows the explanation. 


Table 5-2 

Reasons for File Access Errors 


Octal Code 

Explanation/Ac tion 

0 

File not found. The named file was not 
found by CREF. Specify an existing file. 

1 

You specified a directory that does not 
exist. Specify an existing directory. 

2 

Protection failure. You do not have 
sufficient privileges to access the named 
file. Negotiate the needed privileges with 
the system operator or the owner of the 
f ile . 

3 

File being modified. Another job is 
currently modifying the named file. Try to 
access the file at another time or use a 
different filename . 

14 

No room or quota exceeded. You exceeded 
the quota of the named directory, or the 
entire capacity of the file structure. 
Delete and expunge some of your files, or 
specify a directory or structure with 
sufficient space. 

15 

Write-lock error. You requested an output 
file on a write-locked device, such as a 
magnetic tape. Either write-enable the 
device and try again, or specify another 
device . 


The status code in various CREF error messages is an octal number that 
is best interpreted as bits. For example, if a CREF message prints 
the status code 40001, this means that you have exceeded your disk 
quota. The status code printed by CREF is the logical "OR" of all 
applicable bit values. Table 5-3 contains these status codes, their 
meanings, and the corresponding remedial action. 
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Table 5-3 

Error Status Codes 


Status Code 

Meaning/Action 

400000 

The device is write-locked. Either specify 
a write-enabled device or ask the system 
operator to write-enable your device. 

200000 

A hardware error occurred. The hardware is 
in error and should be fixed if the problem 
persists. 

100000 

A parity error occurred. The data on the 
device is incorrect. Correct the data and 

- 

try again. 

40000 

Quota exceeded or structure full. You 
either exceeded your directory's quota or 
the entire capacity of the structure. 
Delete and expunge some files or specify a 
structure or directory with sufficient 
space . 


NOTE 

All other bit values (such as 20000 or 
10) are simply status bits and do not 
indicate an error. Only those listed 
above indicate an error. Any other code 
simply indicates the status. 


5.5 TECHNICAL NOTES 

The information in this section is primarily for users who write their 
own compilers (such as MACRO, ALGOL, or FORTRAN) and users who create 
. CRF files. It describes the . CRF input file format and the various 
control characters that you use. 

The control characters in Tables 5-4 and 5-5 appear in the CREF input 
file produced by MACRO, FORTRAN and ALGOL. At the beginning of each 
line of the listing, CREF input data is enclosed by DELETE B and 
DELETE C. The symbol or instruction types and the number of their 
component characters are defined by control characters. The set of 
control characters defining symbols and instructions is the same as 
the set defining the number of symbol or instruction characters. A 
control character's position determines its function. For example, in 
the input CREF data <DELETE>B / 'C /s CEND<DELETE>c , the <DELETE>B indicates 
the beginning of the data. The first CTRL/C (~C) defines the 
instruction END as a pseudo-op code. The second CTRL/C (~C) defines 
the number of characters in the instruction END as 3, and the 
<DELETE>C terminates the CREF data. 


5-14 






THE CREF PROGRAM 


Symbols referenced in a block-structured language such as ALGOL should 
assign a unique number to each symbol name. This ensures that symbols 
with the same name but defined in different blocks have different 
numbers. Then, the number for each symbol should be referenced in 
CREF data rather than the name. After the last use of a symbol 
(usually at the end of its block) , use CTRL/I to associate the 

symbol's name with the unique number assigned to it. 

Control characters that require two symbols (such as CTRL/I) should 
have two adjacent length character and symbol name pairs. 

The control characters that begin and end the CREF input data are 
described in Table 5-4. 


Table 5-4 

Beginning and Ending Control Characters 


Character 

ASCII Codes 

Meaning 

C del )a 

(prints as A) 

177, 101 
(Octal) 

Terminates the CREF data on 
each line and adds a 
horizontal tab to the line of 
the listing. 

Q>£l) B 

(prints as B) 

177, 102 

Signals beginning of the CREF 
data on each line. 

QeT)C 

(prints as C) 

177, 103 

Terminates the CREF data on 
each line. A line number is 
incremented and printed. This 
is the line number referenced 
in the CREF tables. 

( del )D 

(prints as D) 

177, 104 

Identical to DELETE A, except 
that DELETE D does not 
increment or print line 
numbers . 

QeT)E 

(prints as E) 

177, 105 

Causes CREF to print its 
tables immediately, and 
reinitializes the tables for 
another program. FORTRAN uses 
this function between 
subroutines . 

(~deT)F 

(prints as F) 

177, 106 

Identical to DELETE C, except 
that DELETE F does not 

increment or print line 

numbers . 


Table 5-5 contains the control characters that define symbols, 
instruction types, and macros. Except for CTRL/B and CTRL/G, each of 
these characters precedes the symbol name being referenced. 
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Table 5-5 

Symbol-Definition Control Characters 


Character 

ASCII Code 

Meaning 

(ctrl/a)( " a) 

001 

Declares a reference to a 
user-defined symbol (such as a 
regular MACRO symbol or a 
FORTRAN variable) . 

(ctrl/b)( ~ B) 

002 

Declares a defining occurrence 
of a user-defined symbol. 
This character immediately 
follows the symbol name. 

(cTRL/()( ~ c ) 

003 

Declares a reference to a 
MACRO pseudo-op or a 
hardware-defined op code. 

(ctrl/d) ( ~D) 

004 

Declares a defining occurrence 
of a MACRO pseudo-op or a 
hardware-defined op code. 

(c trl/e)( ~ E ) 

005 

Declares a reference to a 

macro or OPDEF . 


006 

Declares a defining occurrence 
of a macro or OPDEF. 

(( TRL/c) ( ^G) 

007 

Causes CREF to delete the last 
symbol that it read. 

(ctrl/h)( H ) 

010 

Combines two symbols that are 
defined at different block 
levels and are then found to 
be the same. The second 
symbol specified becomes the 
name for both. For example, 
in a one-pass block-structured 
compiler that allows symbol 
references before their 
definition, a symbol 
referenced in an inner block 
must be treated as a unique 
symbol until the end of the 
block. If no local definition 
is found, this symbol's 
references must then be 
combined with an outer block's 
references . 

(CTRL/l)("l) 

011 

Declares the user-defined 
symbol by giving it a name in 
place of the unique numeric. 
The numeric is the first 
argument, and its name is the 
second argument. 
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Table 5-5 (Cont.) 

Symbol-Definition Control Characters 


Character 

ASCII Code 

Meaning 

(CTRL/j)( ~ J) 

012 

Illegal in CREF as a symbol 
definition control character. 

(ctrl/k)( ~k) 

013 

Identical to CTRL/I , except 
that it operates on macros 
rather than on symbols. 

(ctrl/l) ( ~L) 

014 

Illegal in CREF. 

(ctrl/m) ( ~M) 

015 

Declares the beginning of a 
symbol block. The argument is 
the block name. 

(ctrl/n)( ~N) 

016 

Declares the end of a symbol 
block. The argument is the 
block name. 

(CTRL/0)( ~ Q ) 

017 

Declares a line number to use 
in place of the line's actual 
position in the file. The 
line number is specified after 
the CTRL/O in the same format 
as other symbols. 


The octal value of each character described in Table 5-6 is used by 
2REF to determine the number of characters in a symbol name. The same 
set of characters defines the symbol as well as its number of 
characters. The character's position determines its function. The 
character-count character immediately precedes the symbol with no 
Intervening spaces or characters (~CEND, for example). Table 5-6 
contains the characters and their meanings. 


Table 5-6 

Char ac ter -Count-Definition Characters 


Character 

ASCII Code 

Meaning 

(CTRL/ A) ( ~ A) 

001 (octal) 

The symbol contains 1 
character . 

(ctrl/b)( B) 

002 

The symbol contains 2 
characters . 

(CTRL/C) ( ~C) 

003 

The symbol contains 3 
characters. 

? 

077 

The symbol contains 63 
characters . 
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The following example illustrates the symbols and references 
recognized by CREF that you can make in an Assembly Language Program. 
The control characters show the references that are made to particular 
symbols . 


Source 

File CR'EFD ♦ MAC : 



TITLE 

SUBTTL 

CREED CREF E 

Show Internal 

sample 

C R E F I n f o r m a t i o n 


SEARCH 

MACSYM 9 MONSYM 

y P s e u d o - o p r e f e r e n c e 


CONST* 

17 

y S w m b o 1 d e f :i. n :i. t i o n 


DEFINE 

OPCODE 

MACRO (XX 

X 

Pseudo-op reference ? macro definition (in 
5 0 P D E F a n d s \.i m b o 1 r e f e r e n c e ( w h e n e >: p a n d e d ) 


OPDEF 

OPCODE! MOVE I 1 

y P s e u d o -op refer e n c e y 0 P D E F d e f i n i t i o n a n d 

5 opcode reference 

start: 

MACRO 

CONST 

y S y m b o I a ri d m a c r o refere n c e 


END 

START 

y P s e u d o - o p a ri d s « iti b o 3. refe r e n c e 
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6.1 INTRODUCTION 

The MAKLIB program organizes and manipulates files of relocatable 
object (REL) modules. These REL modules are the output from a source 
language translator, such as the FORTRAN compiler or the MACRO 
assembler . 

At load time, the modules are linked together to build an executable 
program. As shown in Figure 6-1, the MACRO assembler processes two 
source files, X.MAC and Y . MAC , and produces two corresponding . REL| 
files, X.REL and Y . REL . The LINK program then loads the resulting 
object modules from these .REL files and produces an executable 
program, Z.EXE. 



Figure 6-1 Generation of an .EXE File 


Multiple modules can be concatenated into a single file called a 
library. A file containing a single module can also be called a 
library. (See Figure 6-2.) 


6-1 


THE MAKLIB PROGRAM 



Figure 6-2 Generation of a Library 


MAKLIB performs four functions on library files. Each function has 
switches that cause the MAKLIB program to do a specific task. The 
four functions are: 

Obtaining Information about Libraries 

These switches cause MAKLIB to give information about the status 
and contents of the library. 

Manipulating Libraries 

These switches cause MAKLIB to create new libraries by combining 
modules. Other switches cause MAKLIB to add, delete, extract, or 
replace modules. 

Modifying Libraries 

These switches cause MAKLIB to create new libraries from existing 
libraries, either by adding an index or removing local symbols. 
By modifying libraries you can reduce the amount of processing 
time required by the LINK program. 

Editing Libraries 

These switches cause MAKLIB to edit (or patch) modules within the 
library. You selectively change the object code in a module by 
supplying MAKLIB with the required MACRO assembly language code 
changes. 

For more information on the contents of .REL files and REL Block 
types, refer to the TQPS-20 LINK Reference Manual . For more 
information on MACRO assembly language, refer to the TQPS-20 MACRO 
ASSEMBLER Reference Manual. 
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6 . 2 RUNNING MAKLIB 


To run MAKLIB , type MAKLIB after the 
RETURN key. The program prompts you 


TOPS-20 prompt (@) 
with an asterisk: 


and press 


the 


@maklibQll) 

* 


After this prompt, enter a command string. MAKLIB takes commands in 
the following format: 

Destination file spec=Source file specl/Swi tches , Source file 
spec2/Switches. . . Source file specn/Swi tches 

where : 

Destination file specification is the output file that MAKLIB 
produces. It can be either a text file or a library, depending 
upon the function you perform. 

If you do not specify a Destination file name, MAKLIB uses the name of 
the file in Source file sped. If you omit the Destination file type, 
the default depends on the function you perform. 


Source file sped is the master library. This file specification 
is always required in a MAKLIB command string. 

You must specify a file name in Source file sped. The default file 
type is always .REL. 

Source file spec2 ...Source file specn are the transaction files. 
These are additional input files required to perform some MAKLIB 
functions. A function usually requires only one transaction 
file. 

You include switches in the command string to instruct MAKLIB to 
perform a specific function. You specify switches in one of the 
following formats: 


/Switch 

/Switch : argument 

/Switch : (a rgl,arg2. . .argn) 


You can perform only one action with a switch in a single command 
string, but MAKLIB allows up to 100 switch arguments for each command 
s tr ing . 

You can use MAKLIB switches in abbreviated form as long as they remain 
unique. However, arguments to switches are usually module names and 
hence cannot be abbreviated. Parentheses are optional when you 
specify only one argument, but are required to enclose two or more 
switch arguments. 

Table 6-1 (in Section 3) is an alphabetical list of the MAKLIB 
switches; they are discussed in detail in Sections 6.2.1 through 

6.2.4. 


You can use an indirect file in a MAKLIB command string to reference 
another file. The indirect file can contain a complete or partial 
MAKLIB command string (file names and switches). For more information 
on using indirect files, refer to the TOPS-2Q User's Guide . 


If you always want to use specific switches when you run MAKLIB, you 
can put these switches in a SWITCH.INI file. For more information on 
creating a SWITCH.INI file, refer to the TOPS-2Q User's Guide . 


MAKLIB Version 2B 
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MAKLIB allows you to type a string of commands on one or more lines. 
If the command string takes more than one line, type a hyphen (-) at 
the end of. the first line, and press RETURN. Then, when MAKLIB 
prompts with a pound sign (#) , continue to type the command string on 
the next line. You can also use multi-line commands in an indirect 
file . 

To exit from MAKLIB and return to TOPS-20 command level, type either 
/EXIT or CTRL/Z after the asterisk prompt. 


6.2.1 Running MAKLIB to Obtain Information About Libraries 

MAKLIB contains four switches that allow you to obtain information on 
the status and contents of the master library (first input file). The 
four switches are: /LIST, /POINTS, /TRACE, and /LOAD. 

Command String Requirements - 

Files: A master library and an output file are 

required in the command string for each of 
the four switches. None of the command 
strings require a transaction file. 

Default file type: Output file type - . LST 

Master library type - .REL 

Arguments: (Modules affected by the switch) - None 

The output file (.LST) is a text file that can be written to any 
output device that supports text files, such as TTY: or LPT:. The 
discussion of /POINTS in this section illustrates the use of this 
option . 

/LIST - LIST Switch 

This switch lists the names of the modules that are contained in 
the master library. In addition to the names, MAKLIB also lists 
the two data values from the END block (REL Block type 5) of the 
module. If the module is a two-segment program, the first value 
is the high-segment break, and the second value is the 
low-segment break. If the module is a one-segment program, the 
first value is the program break, and the second value is the 
absolute break. If the second value is zero, it is not printed. 

For example, if you want to create a file, REAP. LST, showing the 
names of all modules in the library IAGO.REL, give the following 
command string: 

0MAKLIB QED 

*REAP. LST= I AGO. REL/L 1ST C^P ) 

* 

When MAKLIB finishes the task you request, it prompts you with 
another asterisk. You can now enter another command string. 
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You get the following when you type the new file: 

(3 TYPE (FILE) REAP.LSTCUD 
I.. :i. s t i n rA o f M o d u 1 e s 

F : ' r o d u e e d b y M A K L I B Vers :i. o n 2 A (67) o n 1 2 - v J u n - 7 9 a t 1 4 $ 0 2 $ 4 1 

•J/ \U ’J/ \l/ \l/ \1/ %!/ \b vi/ vl/ \l/ \I/ \|/ vl/ vl/ vl/ vl/ d/ vl/ vl/ \!y *1/ vl/ vl/ \1/ \1/ 

/f\ /|\ /Jv /|\ /|^ /|\ /|\ /|% ^|\ /|\ /[% /|N /|\ /|\ /|\ ^|\ /|% /)\ /|\ p|% /j\ /JV /|\ /j\ 

DSK ♦ I AGO ♦ REL. C 4 y 244 1 created on B-Jurv-79 a t 14 *32 *00 

I AGO 401725 023746 

0 

The output file REAP . LST shows that the file IAGO.REL contains 
one module named IAGO. This module is a two-segment program. 
The first value listed, 401725, is the high-segment break. The 
second value listed, 023746, is the low-segment break. 

/POINTS - POINTS Switch 

This switch lists all entry points in the specified library. 
Entry points are usually subroutine starting addresses. They are 
used by the LINK program to determine if a global request can be 
satisfied by loading a module from a library. 

For example, if you want to know all the entry points in the 
library NICE. REL and have the output written to the device TTY: 
(your terminal), do the following: 

G MAKL1BQFT) 

>K TTY : = NI CE * REL/F'QINTSr^D 

Listing of Modules and Entry Points 
Produced by MAKLIB Version 2 A (67) on 12- Jun-79 at 16 $33 $45 

D S K $ N I C E ♦ E E L I" 4 v 244 1 e rea t e d o n 1 2 - J u n -79 a t 1 6 $ 1 1 $ 0 0 

NICE BEGIN LOOP NICE 
* 

In this example, the output shows that the library NICE. REL 
contains one module, NICE, which has three entry points: BEGIN, 
LOOP, and NICE. After the output, MAKLIB returns with the 
asterisk prompt and waits for another command string. 

/TRACE - TRACE Switch 

This switch lists all the edits you have made to a library. This 
information is contained in the TRACE blocks in the specified 
library. MAKLIB creates these TRACE blocks (REL Block type 1060) 
when you use /FIX to edit a module in the library. The TRACE 
blocks contain information about the edits you insert and the 
changes you make to the library. For more information on TRACE 
blocks,, refer to Section 6.5. /TRACE allows you to determine the 
exact binary patching status of the library. 
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For example, if you want to see all the edits in the library 
OLDLIB.REL, and have the output written to the device TTY:, do 
the following: 


G? M A K L I I X ret ) 


*tty:=old l :i: b ♦ r el* l / t r a c el 

L i s t i n ^ o f T R A C EL b 1 o e k a 

P r o d u c e d b y M A K L I B V e r s i o n 2 A (67) o n 1 0 •••■ J u 1 - 7 9 a t 9 X 33 : 59 

D S K * 0 L D L I B * R EL L LA v 6 0 1 LI c r e a t e d o n 1 - J u n - 7 9 a t 9 1 3 1 X 0 0 


Module ♦ SORT Edit: 341 
S t a t • j s i s A c t i v e 
Last affected by DRB 
Created by HAS On 2-Jun-79 
Installed by DRB On iO-Jul-79 
P r o <2 r a m c h a n sles ♦ 

I n s e r t s 4 :i. n s t r u c t :i. o ri ( s ) a t 1 o c a t i o n 0 0 1 046 


This example shows that the module SORT in the library OLDLIB.REL 
has one edit inserted. The status of the edit is active. You 
can change the status of a particular edit with the .REMOVE or 
.REINSERT pseudo-ops. The example also shows that the edit was 
last affected by DRB. This information comes from /WHO when you 
install or change an edit. The edit was created by HAS on 
2-Jun-79. This information comes from the .NAME and .DATE 
pseudo-ops, respectively. The edit was installed by DRB on 
10-Jul-79. This information comes from /WHO and the date that 
the system supplies when you install an edit. For more 
information on these pseudo-ops and /WHO, refer to Section 6.2.4. 

/LOAD - LOAD Switch 

This switch shows additional loading instructions that are 
embedded within the library in either REQUEST (REL Block type 
17), REQUIRE (REL Block type 16), or ASCII text blocks. 

The library QUICK. REL was produced from a MACRO program 
containing the following statements: 


title: 

♦ TEXT 

♦ REQUEST 
♦REQUIRE 


QU ICK 

" /VERSION $2(1 1 1) " 
SYS ♦ FORLIB 
SYS ♦ M AGREE 


To see the additional loading instructions embedded within 
QUICK. REL in the blocks, do the following: 


GWAKLIBGfD 

)KTTY : -QUICK ♦ REL/LOADQiD 

L i <;> t i n <•* o f I n t e r n a 1 1 o a d i n <3 i n s t r u c t i o n s 
P r o d u c e d b y MAKLIB Ue r s i o n 2 A ( 6 7 ) o n 1 0 - J u 1 - 7 9 a t 9 X 06 t 2 3 

\i/ \1/ \l/ vl/ \i/ \i/ * J/ \ 1/ \I / \|/ \1/ Oy \l/ \l/ vl/ \l/ \l/ vl/ vly \l / vl/ \1/ vl/ \l/ \f/ \|/ 

/|\ /f\ /|\ /|\ /|\ /|N /J\ /|\ /J\ I' 4^ O' 4' 4> 

DSK:aUICK*RELC4»6013 created on 6-Jul-79 at 13:28100 
Module : QUICK 

Text string: /VERSION :2< 111 ) 

R e o u e s t s SYS: F 0 R L I B 
Requires SYS :M AGREE 
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6.2.2 Running MAKLIB to Manipulate Libraries 

For handling and creating libraries, MAKLIB includes six switches that 
allow you to work with individual modules within libraries. The six 
switches are: /MASTER, /APPEND, /DELETE, /EXTRACT, /INSERT, and 

/REPLACE. 

Command String Requirements - 

Files: A master library (first input file) and an 

output file are required in the command 
string for each of the six switches. A 
transaction file is required with some 
swi tches . 

Default file type: .REL for all files 

Arguments: All switches accept arguments. /APPEND and 

/INSERT are two switches that do not always 
require arguments. For more information, 
refer to the discussions of these two 
switches in this section. 

/MASTER - MASTER Switch 

This switch identifies modules within the master library that 
correspond to those in the transaction file being used to effect 
the update. /MASTER takes at least one argument, and requires 
that another switch be given in the same command string. It is 
the only switch within this function that causes no real 
manipulation of a library. It is mentioned here because some of 
the switches used to manipulate libraries require /MASTER in 
their respective command strings. 

You include /MASTER in the command strings for only two switches, 
/INSERT and /REPLACE. These switches are discussed later in this 
section . 

/APPEND - APPEND Switch 

This switch adds new modules to the end of an existing library. 
The output file is the master library plus the appended modules. 
MAKLIB reads these appended modules from the transaction file. 
You specify them as arguments to the switch. You must specify 
modules as arguments in the same physical order as they occur in 
the transaction file. Figure 6-3 illustrates the function of 
/APPEND. Note that, in the figure, modules D and E from the 
transaction file are appended to the master library. 
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Figure 6-3 Function of /APPEND 


NOTE 

When you do not specify an argument to /APPEND, the 
entire transaction file is appended to the master 
library. 
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For example, you want to append the module IAGO in the library 
I AGO . REL to the library GRAF.REL. You name the output file 
EXEN.REL. The command string is: 

id MAKLIB C ret ) 

# EXEN ♦ R EL. ~ GRAF . REL. > IAGO . REL/APPEND J I AGOCUD 

* 

MAKLIB returns with the asterisk prompt for you to enter another 
command string. To check the new file, use /LIST and have the 
output written to the device TTY:. 

* TTY : -EXEN ♦ REL/L I ST CUT) 

L i s t i n 3 o f M o d u 1 e s 

F* r o d u c & d b y M A K L I B U e r s i o ri 2 A ( 6 7 ) o ri 1 4 - J u n — 7 9 a t 1 () £ 4 5 * 1 3 

D S K t E X E N ♦ R E L II 4 9 2 4 4 II c r e a t e d o n 1 4 • J u n - 7 9 a t 1 0 ♦ 4 3 ♦ 0 0 


GRIG 

00 4502 



PASZ 

003217 



TENP 

036651 



IAGO 

* 

402420 

023746 


The example 

shows that the 

new file, EXEN.REL, 

contains four 

modules : 

the three modules from the library 

GRAF.REL (CRIG, 


PASZ , TENP) , and the appended module IAGO. 

/APPEND also allows you to initially create a library. For 
example, you wish to combine the following four .REL files into a 
single library: 

GLOBAL. REL 
DTABLE . REL 
INOUT.REL 
10. REL 

Type the following MAKLIB command string to produce the file 
LIB. REL, which contains all modules from the four specified 
files : 


E NAKLIB C ret ) 

>K LIB=GLOBAL * DTABLE/ APPEND i INOUT /APPEND 9 IO/APPENDGlEl) 

% 

In this example, MAKLIB copies the file GLOBAL to a file named 
LIB, and then appends all modules from the files DTABLE, INOUT, 
and 10 to LIB. This also illustrates the use of more than one 
transaction file. 

/DELETE - DELETE Switch 

This switch removes one or more modules from an existing library. 
The output file is the master library minus the deleted 
module ( s) . All modules, except those specified as arguments to 
/DELETE, are read from the master library and copied to the 
output file. No transaction file is required. 
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NOTE 

You must specify modules as arguments in 
the same physical order as they occur in 
the master library. 


Figure 6-4 illustrates the function of /DELETE. Note that, in 
figure, module B is deleted from the master library. 



Figure 6-4 Function of /DELETE 


the 
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Type the following command string to delete the module TENP from 
the library EXEN.REL. The output filename is DIPEP.REL. 


(bmaklibGID 

#DIPEP ♦ REL=EXEN ♦ REL/DELETE ? ( TENP ) f^D 
* 

The program returns with the asterisk prompt for you to enter 
another command string. To check the new file, use /LIST and 
have the output written to the device TTY:. 

* T T Y : = D I P E P . R E L /LIS tChD 

L i s t i n & of M o d u 1 e s 

p r o d u c e d b w M A K L. 1 B 0 e r s i o n 2 A (67) o n 1 4 - J u n - 7 9 a t 14110? 4 1 
%*%%%%%%%%%%%%%%%*%%%%%%%% 

BSK ? DIPEP ♦ RELC4 y 244!] created on 14-Jun-79 at 14? 10 5 00 


GRIG 004S82 

F'ASZ 003217 

I AGO 402420 023746 

>K 

/EXTRACT - EXTRACT Switch 

This switch produces an output file that is a subset of modules 
in the master library. You specify the modules as arguments to 
the switch. No transaction file is required. 


NOTE 

You must specify the modules as 
arguments in the same physical order as 
they occur in the master library. 


Figure 6-5 illustrates the function of /EXTRACT. Note that, in 
the figure, module A is extracted from the master library. 


6-11 



6-12 



THE MAKLIB PROGRAM 


The following example illustrates /EXTRACT. The library FOO.REL 
contains four modules. To get a listing of the module names, use 
/LIST and have the output written to the device TTY:. 

QMAKLIB C ret ) 

* T T Y : * F 0 0 ♦ R E L / L 1ST CUD 

L i s t i n si o f M o d u 1 e s 

R r o dues d b y M A K L I B 'v 1 e r s i o n 2 A ( 6 7 ) o n 1 8 - J u n — 7 9 at 14*37*4 5 

DSK ♦ FOG ♦ RELC4 » 2443 created on 18-Jun-79 at 13 : 54 J 00 


SQUARE 000023 
BOX 000014 

MAIN 000433 
DRAW 000505 
* 

You want to extract two of these modules, SQUARE and BOX, from 
the library FOO.REL, and put them in a new library, 2FOO.REL. 
After using /EXTRACT, check on the new file with /LIST, and have 
the output written to the device TTY:. Type the MAKLIB command 
string after the asterisk prompt: 

* 2F00 * REL=F 00 * RE L/EXTRACT : ( SQUARE > BOX )QID 
* TTY : =2F00 ♦ rel/listCUD 

L i s t i ri si a f M o d u 1 e s 

P r o d u c e d b y M A K L I B U e r s i o ri 2 A ( 67 ) o n 1 8 • j ri ~~ 7 9 a t 1 4 * 5 7*17 

DSK ♦ 2F00 *RELE:4 y 2441 created on 18~Jun~79 at 14 1 56 t 00 


SQUARE 000023 
BOX 000014 
* 

The example shows that the new library, 2FOO.REL, contains the 
two modules that you extracted from the master library, FOO.REL. 

/INSERT - INSERT Switch 

This switch inserts new modules into a master library. /MASTER 
is required in the command string. The output file is formed as 
follows: MAKLIB copies the master library to the output file up 
to but not including the module named as the first argument to 
/MASTER. Next, MAKLIB copies the module named as the first 
argument to /INSERT from the transaction file to the output file. 
The process repeats until the argument list specified to /MASTER 
and /INSERT is exhausted. At this point, MAKLIB copies the 
remaining modules in the master library to the output file. 
There must be one argument to /MASTER for every argument to 
/INSERT. 
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NOTE 

You must specify the module names in the 
argument lists for /MASTER and /INSERT 
in the same physical order as they occur 
in the master library and the 
transaction file, respectively. When 
you do not specify an argument to 
/INSERT, the entire transaction file is 
inserted before the module you specify 
to /MASTER. You must always specify an 
argument to /MASTER. 


Figure 6-6 illustrates this function of /INSERT. Note that, in 
the figure, module X in the transaction file is inserted before 
module B in the master library. 



Figure 6-6 One Function of /INSERT 
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For example, the library FOO.REL contains four modules: SQUARE, 
BOX , MAIN , and DRAW. The library NICE . REL contains one module, 
NICE. You want to insert the module NICE before the module BOX 
in FOO.REL. The name of the output file containing the five 
modules is CLAR.REL. The command string to insert this module is 
as follows: 


PMAKLIB C^T) 

*clar,rel=fqo*rel/master: box * nice ♦rel/insert:niceGED 
* 


MAKLIB returns with the asterisk prompt. You can now check on 
the new library, CLAR.REL, with /LIST. The output from /LIST is 
written to the device TTY: 

*TTY : =CLAR ♦ REIL/LISTCED 

L i s t i rt 3 o f Mod u I e s 

P r o d u c e d by M A K L IB U e r s i o n 2 A < 6 7 ) a n 2 7 - J u n - 7 9 a t 15*40*28 


\1/ • J/ vl/ \1/ si/ \1/ \1/ \l/ U/ \1/ \1/ \1/ \l/ si/ \|/ O/ \l/ si/ \1/ si/ vl/ \i/ \I/ si/ 



SQUARE 


0 000 2 3 
005557 
000014 
000433 
000505 


NICE 

BOX 

MAIN 

DRAW 

* 


You may also insert more than one module in front of a module in 
a master library. However, the master library module name must 
appear repeatedly in the argument list to /MASTER. This produces 
a one-to-one correspondence between the module ‘in the master 
library and the modules you wish to insert. In this case, you 
must list the argument names for both /MASTER and /INSERT in the 
same physical order that they appear as modules in the master 
library and transaction file, respectively. 


Figure 6-7 illustrates this function of /INSERT. Note that, in 
the figure, modules X and Y in the transaction file are inserted 
before module B in the master library. 
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OUTPUT 

FILE 


MR-S-594-80 


Figure 6-7 One Function of /INSERT 
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For example, the library SFJA.REL contains two modules: ILJA, 

and HLBET . The library FOO.REL contains four modules: SQUARE, 

BOX, MAIN, DRAW. You want to insert both modules in SFJA.REL in 
the library FOO.REL, before the module DRAW. The name of the new 
library is SFOO.REL . The command string is: 

QMAKLI BQlD 

*SFQO,REL=FOO.REL/MASTER! < DRAW* DRAW) * SFJA.REL/ INSERT? ( ILJA > HLBET >C«D 

* 

After the asterisk prompt, check on the contents of the new 
library, SFOO.REL, with /LIST and have the output written to the 
device TTY : . 


*TTYJ=:SFOO*REL/LISTQeD 

Listing of Modules 

Produced by MAKLIB Version ■ 2A < 67 > on 28~~Jun~79 at 16:30:22 


DSK:SF00*RELC4^244: created 


SQUARE 000023 
NICE 005557 
BOX 000014 
MAIN 000433 
ILJA 001047 
HLBET 000433 
DRAW 000505 
* 


on 28-Jun-79 at 16 : 30 : 00 


/REPLACE - REPLACE Switch 

This switch replaces modules in the master library with those 
specified in the transaction file. /MASTER is required in the 
command string so that the program can identify the modules in 
the master library that are to be replaced by those named as 
arguments to /REPLACE. There must be a one-to-one correspondence 
between the number of arguments to /MASTER and /REPLACE. 

The output file is the entire master library, with modules 
replaced by those read from the transaction file (and named as 
arguments to the switch) . 


NOTE 

You must specify the names in both 
argument lists (/MASTER and /REPLACE) in 
the same physical order as they appear 
as modules in the master library and 
transaction file, respectively. 


Figure 6-8 illustrates the function of /REPLACE. Note that 
module X in the transaction file replaces module B in the master 
library. 
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Figure 6-8 Function of /REPLACE 


For example, the library FOO.REL contains four modules: SQUARE, 

BOX, MAIN, and DRAW. The library NICE . REL contains one module, 
NICE. You want to replace the module MAIN in FOO.REL with the 
module NICE in NICE. REL. The output file name is WELW.REL. The 
command string is the following: 

PMAKLIBC^P 

*UELU ♦ REL=FQ 0 ♦ REL/M ASTER : MAIN * NICE ♦ REL/REPLACE : NICEQeD 

* 
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After MAKLIB completes the action you requested, it prompts you 
with an asterisk. Now check on the contents of the new library, 
WELW.REL, with /LIST and have the output written to the device 
TTY: . 


>ktty:=welw*rel/listGID 

Listing of Modules 

P r o d u c e d b y M A K L I B U e r s i o n 2 A (67) o n 6 - J u 1-79 a t 1 A 149$ 2 2 

/|V ^J\ /|\ /J\ /|\ /(\ /j\ Sf\ /p /pw /p /|\ /p /J\ /p. /|' ^ /p /|^ /p 

DSK:WELW*RELC4^244 3 created or. 6-Jul -79 at 14 MB 1 00 


SQUARE 000023 
BOX 000014 
NICE 005557 
DRAW 000505 
* 

NICE replaced MAIN in the master library FOO.REL. The new 
library, WELW.REL, contains the four modules: SQUARE, BOX, NICE, 
and DRAW. 


6.2.3 Running MAKLIB to Modify Libraries 

The two switches within this function facilitate the processing of 
requests by the LINK program when it loads modules from libraries. 
The two switches are: /INDEX and /NOLOCALS. 

Command String Requirements - 

Files: A master library (first input file) and an 

output file are required in the command 
string for both switches. Transaction files 
are not allowed. Both switches appear with 
the master library in the command string. 


Default file type: .REL for both the master library and the 

output file for both switch command strings. 

Arguments: None 

/INDEX - INDEX Switch 


This switch produces an output file, which is identical to the 
master library, except with INDEX blocks (REL Block type 14) 
inserted in the file. Normally, programs make external requests 
to library subroutines they need, and LINK must search completely 
through the library to decide which modules to load to satisfy 
the requests. INDEX blocks list the entry point names and 
corresponding modules, allowing LINK to quickly determine which 
modules to load. LINK searches more efficiently, and loading 
time is shorter because the amount of I/O is reduced. 
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/NOLOCALS - NOLOCALS Switch 

This switch produces an output file which is the master library 
with all local symbols deleted from the file SYMBOL blocks (REL 
Block type 2). Local symbols are useful for debugging purposes, 
and also when modules are edited with MAKLIB. (Refer to FIX 
files , Section 6.2.4.) In a production-mode library, local 
symbols are usually deleted, because they serve no purpose. This 
reduces the amount of mass storage space the library occupies. 
In addition, loading time is faster because the amount of I/O is 
reduced. Global symbols are not deleted because they are used in 
the linking of modules. 

In the following example you create a new library, L2, from Ll. 
The new library has an index but no local symbols. You can use 
/INDEX and /NOLOCALS together in the command string. 

(3MAKL IB fSO 

*L2-L1/N 0 L 0 C A L S / 1 N D El XQID 
* 


6.2.4 Running MAKLIB to Edit Libraries 

MAKLIB provides a mechanism for you to patch (or edit) the code of a 
relocatable object module. This patching facility allows you to make 
program changes directly to a library. Although MAKLIB provides the 
facility for editing a program without having to change the source 
code, good programming practice requires that the same edits also be 
made at the source level. 

To edit a library in this way, you must first create a text file 
called a .FIX file. This .FIX file contains one or more edits that 
you want to insert in the library. Each edit has a unique identifier 
and consists of a sequence of control pseudo-ops and MACRO assembly 
language code. The control pseudo-ops tell MAKLIB where and how to 
make the changes. Any new code is supplied as a sequence of MACRO 
assembly language statements. Each edit begins with a .EDIT pseudo-op 
and ends with a .ENDE pseudo-op. Figure 6-9 shows the order that 
pseudo-ops must appear within an edit. 

When MAKLIB processes the .FIX file, it creates a new library with any 
new edits inserted. Although each edit is now a permanent part of the 
library, you can use MAKLIB to deactivate an edit. This operation 
effectively removes any code changes inserted by the edit. Therefore, 
edits in the library can be either active or inactive. 

MAKLIB maintains edit history information on the library by generating 
TRACE blocks (REL Block type 1060) for each edit you insert. TRACE 
blocks are part of the module. Therefore, when you use /REPLACE, 
/EXTRACT, or /DELETE, the TRACE blocks move with the module. Section 
6.2.1 describes how you can determine the edit status of the library 
using /TRACE. 


NOTE 

MAKLIB does not handle PSECTS. 
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Pseudo-ops for .FIX files 

.EDIT xxxxxx - This pseudo-op is an identifying name for the edit 
you insert in the specified module. The edit name (xxxxxx) can 
be up to six (6) SIXBIT characters and is stored in the TRACE 
block for any module affected by the edit. .EDIT is the first 
pseudo-op for each edit. 

.DATE dd-mmm-yy - This pseudo-op gives the date that the edit was 
made. The day (dd) and year (yy) entries are numeric. The month 
entry (mmm) is alphabetic. .DATE is an optional pseudo-op. If 
you supply this information, it is stored in the edit TRACE 
block . 

.NAME xxx - This pseudo-op gives the three initials (xxx) of the 
person who wrote the edit. .NAME is an optional pseudo-op. If 
you supply these initials, they are stored in the TRACE block for 
the edit. 

.MODULE xxxxxx - This pseudo-op gives the name (xxxxxx) of the 
module that you wish to edit. It is the module name as it 
appears in the library, up to six Radix-50 characters. Once you 
give a name, that module is loaded. Editing continues with this 
module unless a new .MODULE pseudo-op is given. You do not have 
to edit modules in the same order that they reside in the master 
library (first input file). However, each module may be named 
only once within an edit. 

.ASSOCIATED +editl , -edit2 , +edit3 , +edi t4 - This pseudo-op 

gives information on which other related edits must be present in 
the specified module. The edit names here are the same as those 
designated under the .EDIT pseudo-op. The "+" indicates that the 
edit is required. The indicates an edit that conflicts with 
the current edit? you cannot have both edits active 
simultaneously. You receive notification if the specified module 
does not contain the correct combination of associated edits. 
The default is "+" if no sign precedes the edit name. 
Information you supply with the .ASSOCIATED pseudo-op must 
precede any information supplied in the .FIX file by the .INSERT, 
.REMOVE, or .REINSERT pseudo-ops. 

.VERSION nnnxx ( nnnnnn) -g - This pseudo-op allows you to specify 
the version number of the edit. The version is in standard 
TOPS-20 version format. The nnn designates the major version 
number, which consists of three octal digits maximum. The xx 
designates the minor version, which consists of two letters 
maximum. The (nnnnnn) designates the edit number, and can be up 
to six octal digits. The g designates the code for the group 
that last edited the module, and it is one octal digit maximum. 
All fields are optional. 

.ALTER location , <new value> , Cor iginal value> - This pseudo-op 
changes the contents of a specific location. All code is written 
in angle brackets, < >. The original value at the specified 
location is replaced by a new value. The first argument, 
location, is where you wish to place the new value. Once you 
enter the new value, it is evaluated and placed into the 
specified location. You can specify a third argument, <original 
value>, to check whether the actual original value differs from 
the expected original value. If it does, MAKLIB gives you an 
error message and the location is not altered. 
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.INSERT location, keyword : n , <or iginal value> - This pseudo-op 
allows you to add code to a module. You precede the new code 
with a .INSERT pseudo-op and terminate the sequence with a . ENDI 
pseudo-op. MAKLIB assembles the code and adds it to the module 
in the output file. 


The .INSERT pseudo-op takes three arguments. The first gives the 
location at which you want the new code executed. This argument 
can be a numeric or symbolic expression. This location is 
assumed to be relocatable, and may be in either the low or the 
high segment. The second argument is a keyword that specifies 
how the code is to be located with respect to this location. 
This keyword is one of the following: 


BEFORE 


AFTER 


REPLACE 


REPLACE :n 


Insert the new instructions so that they are 
executed before the instruction at the specified 
location . 

Insert the new instructions so that they are 
executed after the instruction at the specified 
location. 

Delete one instruction from the existing code for 
each one included in the edit, beginning with the 
instruction at the location of the edit. Then, 
insert the new instructions so that they are 
executed in place of the deleted code. 

Delete n instructions from the existing code, 
starting with the instruction at the edit 
address. Then, insert the new instructions so 
that they are executed in place of the deleted 
code. This applies no matter how many 
instructions you insert. The argument may be an 
expression, and is evaluated in the current 
radix . 


You can specify a third argument, Coriginal value>, to check 
whether an actual original value differs from the expected 
original value. If it does, MAKLIB gives you an error message 
and the editing does not take place. This argument gives the 
line of code at the location specified by the first argument. 
The code is written in angle brackets, and is evaluated. It must 
exactly match the code at the specified location. If the code at 
the location is a literal, you must give only the first word. 

MAKLIB always inserts the new code at the end of the current 
segment. It replaces the referenced instruction with an 
unconditional jump to the new code. The format of code insertion 
appears in Section 6.5, Technical Notes. 

Because MAKLIB does not physically insert the code at the 
location you specify, you need to consider a restriction when you 
use this facility. 

MAKLIB constructs a patch that has the effect of a skipping 
instruction, and assumes that it follows an instruction that can 
potentially skip, at most, one instruction. If the intent of the 
patch does not fit these assumptions, it may not work correctly. 
Further, for REPLACE functions, MAKLIB assumes that program 
control can only pass to the first instruction of the deleted 
code. 
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For example consider the following code segment, 

JRST FOG 
JFCL 
JFCL 
JFCL 
JFCL 
JFCL 

and a MAKLIB patch to it: 

♦ INS E R T BAR * R E P LACE ♦ A < J F C L > 

JFCL 

♦ END I 

Note that the JRST FOO instruction at BAR-1 still causes the old 
code to be executed in spite of the patch. 

As another example, consider the following: 

LABEL i OPENFZ 9 A JSYS MONITOR CALL 

ERJMP ERROR 
JFCL 

A patch using .INSERT cannot specify any combination of BEFORE or 
AFTER with location LABEL or LABEL+1 . To do so would separate 
the JSYS and the ERJMP instructions, which must be consecutive to 
operate properly. 

.REMOVE editl,edit2,edit3. . . . - This pseudo-op deactivates the 
specified edits from the selected module. The original 
instructions displaced by the jumps to the edit area for each 
.INSERT are returned to that location. No changes are made to 
the symbol table. The arguments are the edits you wish to 
remove . 

.REINSERT editl , edit2 , edit3 . . . - This pseudo-op activates any 
edits you previously removed with the .REMOVE pseudo-op. 

. ENDI - This pseudo-op marks the ending point of the code 
following the last .INSERT pseudo-op. 

.ENDE - This pseudo-op marks the ending point of the complete 
edit. It also instructs MAKLIB to check for undefined labels or 
other invalid entries within the edit. 


BAR t 
FOO ♦ 
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Figure 6-9 illustrates the order that pseudo-ops appear in a .FIX 
file: 


• EDIT 


j • DATE 
(oNAME 


•MODULE 


• ASSOCIATED 
. REMOVE 

• REINSERT 

• VERSION 
•ALTER 

• INSERT 

® 

• END I 


\ 


•MODULE 


• END E 


MR-S-596-80 


Figure 6-9 Order of Pseudo-ops in a .FIX File 


The MAKLIB program has a one-pass assembler. Because of this, forward 
references to labels and expressions are restricted to simple addition 
and subtraction on the halfword boundary. References to undefined 
labels or symbols are valid where references to external symbols would 
be valid in MACRO (with no polish fix-ups) . Literals are treated as 
forward references, because the actual location of the literal is not 
known until the .INSERT pseudo-op ends. Defining a label inside of a 
literal is not valid. Finally, the value you place in the right-hand 
side of an assignment must not be forward or external. 

It is not required that assignments be inside .INSERT in the .FIX 
file. It is required, however, that the .EDIT and .MODULE pseudo-ops 
precede any assignments, because these define new symbols in the 
symbol table. MAKLIB does not allow redefinitions of existing 
symbols, because it is impossible to backtrack references to a symbol 
in the relocatable binary file. So, any label or symbol you create 
with /FIX must be new to the program. 
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To simplify editing and to keep the appearance of binary edits as 
close as possible to the source level, the following pseudo-ops are 
implemented in the MAKLIB .FIX file assembler and operate as they do 
in MACRO: 


ASCII 

ASCI Z 

BLOCK 

BYTE 

COMMENT 

DEC 

EXP 

IOWD 

OCT 

POINT 

PURGE 

RADIX 

RADIX50 

REMARK 

SIXBIT 

SQUOZE 

XWD 

SUBTTL 

TITLE 


NOTE 

The pseudo-ops BYTE, DEC, OCT, and EXP 
are limited to a maximum generation of 
one word of data. 

All MACRO operators and qualifiers are available except A F. MAKLIB 
also supports the following MACRO pseudo-ops for writing conditional 
code : 


IFN 

IFG 

IFDEF 

IFE 

IFLE 

IFNDEF 

IFL 

I FGE 



You may follow symbols with ## (double pound sign) to indicate that 
they are EXTERNAL quantities. However, if the symbol is defined as 
EXTERNAL (already in the symbol table), you do not have to use ##. It 
is not necessary to follow undefined symbol names with # (single pound 
sign) , since it is assumed that any undefined symbol is a forward 
reference. If a symbol name is already assigned and followed by the 
#, you receive an error message (see Section 6.4, MAKLIB Messages) . 
You may define labels as internal (available to other programs) if 
they are followed by : : (double colon) . Entry points may not be 
defined. The full facilities available in MACRO for combinations of 
DDT suppression and internal declaration are available for both labels 
and assignments. 

Command String Requirements - 

Files: A master library (first input file) and an 

output file are required in the command 
string. The .FIX file is the required 
transaction file. 

Default file type: .REL for both the output file and the master 

library. The default for the transaction 
file is .FIX. 

Arguments: None. 

The editing command string accepts two switches. They are /FIX and 
/WHO. 

/FIX - FIX Switch 

This switch makes changes to the actual code and symbol table of 
a module. It appears with the transaction (.FIX) file 
specification . 
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/WHO:xxx - WHO Switch 

This switch is optional and you use it only with /FIX. You can 
enter it in either the master library or the transaction (.FIX) 
file specification. The argument to /WHO can be up to three 
characters (xxx) . These are usually the initials of the person 
using MAKLIB at the time the edit is installed. If you include 
this information, it appears in the TRACE block of all new edits 
(in the last affected field and in the last installed field). If 
any of these edits change the status of an existing edit (such as 
.REMOVE or .REINSERT), this information is entered in the last 
affected field of the TRACE block of the affected edit. If you 
use /WHO without /FIX, MAKLIB ignores it in the command string. 

In order to edit a library with a .FIX file, you can use the following 
command string. In this example, you use the .FIX file FIXl.FIX to 
edit the library OLDLIB.REL, and create an updated library NEWLIB.REL. 

@MAKLIBQTT) 

*NEWLIB=OLDLIB , FIX 1/FIX/WHO : SFA QTP) 

* 

The following are sample .FIX files. This first example illustrates 
the use of the .INSERT and .VERSION pseudo-ops. One module in the 
library is modified. 


.EDIT 341 
.NAME HAS 
.MODULE GLOB.. 

.VERSION 4 C (341) 

.INSERT START, AFTER, <RESET> 

MOVE P , [ I OWD PDLEN , PDLIST] 

. ENDI 

.INSERT LOOP+3, BEFORE, CJRST LOOP> 

PUSHJ P , NEXTCR 

.ENDI 

.ENDE 


The following edit illustrates the use of .ALTER pseudo-op to change 
the value of a table entry. Location RAD50+46 is changed from a " . " 
to a In addition, this edit uses the .ASSOCIATED pseudo-op to 
specify that this edit also requires edit 343 to the module TABLES. 


.EDIT 344 

.NAME HAS 

.MODULE TABLES 

.ASSOCIATED 343 

.ALTER RAD 5 0 + 4 6 ,<"$">,< 11 ." > 

.ENDE 


This edit uses the .REMOVE pseudo-op to deactivate edit 345 in the 
module FSORT. As a result of this operation, any code that was 
changed by edit 345 will be restored to its previous state. 


.EDIT 346 
.NAME HAS 
.MODULE FSORT 
.REMOVE 345 
.ENDE 
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6.3 MAKLIB SWITCH OPTIONS 

Table 6-1 is a reference table of all MAKLIB program switches. These 
switches are listed alphabetically. The function that each switch 
performs appears beside it in the table. 


Table 6-1 
MAKLIB Switches 


Switch 

Function 

/APPEND 

Adds new modules to the end of an existing 
library . 

/DELETE 

Removes one or more modules from' an 

existing library. 

/EXIT 

Terminates MAKLIB and returns you to 

TOPS-20 command level. 

/EXTRACT 

Produces an output file that is a subset of 
modules in the master library. 

/ FIX 

Makes changes to the actual code and symbol 
table of a module. 

/INDEX 

Produces an output file identical to the 
master library except with INDEX blocks 
inserted in the file. 

/INSERT 

Inserts new modules into the master 

1 ibrary . 

/LIST 

Lists the names of the modules that are 
contained in the master library. 

/LOAD 

Shows additional loading instructions that 
are embedded within the library in either 
REQUEST , REQUIRE, or ASCII text blocks. 

/MASTER 

Identifies files within the master library 
that correspond to those in the transaction 
file being used to effect the update. 

/NOLOCALS 

Produces an output file which is the master 
library with all local symbols deleted from 
the file symbol blocks. 

j /POINTS 

Lists all entry points in the specified 

1 ibrary . 

/REPLACE 

Replaces modules in the master library with 
those specified in the transaction file. 

/TRACE 

Lists all the edits made to a library. 

/WHO 

Specifies the initials of the person using 
MAKLIB when an edit is installed. 
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6.4 MAKLIB MESSAGES 

The MAKLIB program issues two types of messages: fatal errors and 
warning messages. Fatal errors are preceded by a question mark (?) 
and cause the current command to be aborted. Warning messages are 
preceded by a percent sign (%) and indicate that the command will be 
completed , but the operation may not have been performed as you 
intended. 


All messages are typed on your terminal. They begin with a six 
character code that identifies the error. This is followed by a short 
description of the problem. 


MAKLIB uses the command scanner routines SCAN and WILD. The following 
list of messages contains the most common messages that these routines 
produce. These messages begin with SCN or WLD. 

Some of the messages contain information that is dependent on the 
exact command string , switch, or file you wish to process. The key to 
these message variables follows: 


[edit] The name of a specific edit, 

[file] A file specification. 


[label] 

[location] 


[module] 


The name of the label which caused the error. 

The location where the error was detected. 
This is expressed as either a symbolic 
address or as a line number in the .FIX file. 

The name of a specific module. 


[pseudo-op] A specific pseudo-op. 

[statement] A specific statement related to or causing 
theerror. 


[status] 

[switch] 

[symbol] 

[type] 

[value] 

All MAKLIB messages 
six -character code. 


A specific numeric file status code. 

A specific MAKLIB command switch. 

A symbol. (Refer to the TQPS-20 MACRO 
ASSEMBLER Reference Manual for an exact 
definition.) 

A REL Block type. 

A specific value. 

are listed here alphabetically by the 
A suggested user response is provided for each 


-"3 3 — A. v_ w 1 1 J. UJ J 

ratal error and those warning messages that require correction, 


7MKLAAC .ASSOCIATED seen after . INSERT ,. REMOVE or .REINSERT in edit 
[edit] 

Description: In the indicated .EDIT, the .ASSOCIATED pseudo-op 

is out of order. 

Suggested User Response: Move the .ASSOCIATED pseudo-op so that 
it appears before any .INSERTS, .REMOVES, or .REINSERTS. 
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7MKLAAL .ALTER address is not in current module in edit [edit] 

Description: In your edit, you used a .ALTER pseudo-op to change 

the contents of an address. However, you gave an address that 
does not exist in the specified module. 

Suggested User Response: Change the .ALTER pseudo-op so that it 
specifies a legal address. 

%MKLAFI Arguments to /FIX switch are ignored 

Description: In the command string, you gave arguments on /FIX. 

There are no defined arguments for /FIX, so MAKLIB ignores any 
that you specify. 

%MKLAMI Assignment to [symbol] with no module selected was ignored: 
[statement] 

Description: In a .FIX file you assigned a value to a symbol, 

but you did not specify a module. 

Suggested User Response: Change the .FIX file so that the 
assignment statement occurs after the .MODULE pseudo-op. This 
specifies which symbol belongs with a particular module. 

7MKLANA Asterisk not allowed as output file spec 

Description: In the command string you gave an output file name 

that included a wildcard character. 

Suggested User Response: Since wildcard characters are illegal 
for the output file name, reissue the command with an explicit 
output file name. 

7MKLASG FORWARD/EXTERNAL assignment to [symbol] at [location] (Edit 
[edit] ) 

[statement] 

Description: In the specified edit, you assigned a forward or 

external reference. 

Suggested User Response: MAKLIB does not support forward or 
external references. Change the assignment statement. 

7MKLBAM BEFORE, AFTER or REPLACE missing from .INSERT in edit [edit] 

Description: You typed an incomplete .INSERT pseudo-op in a .FIX 

f ile . 

Suggested User Response: Include the required second argument 
for .INSERT indicating how the code should be inserted. 

7MKLBDA Bad .DATE argument for edit [edit] 

Description: In a .FIX file you specified a date that was not in 

a recognizable format for the .DATE pseudo-op. 

Suggested User Response: Specify the date in the form dd-mon-yy, 
such as 7-JUL-77. 


MAKLIB Version 2B 
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7MKLBNI Binary patching tool not included in MAKLIB 

Description: You attempted to use a .FIX file with a version of 

MAKLIB that does not support .FIX files. 

Suggested User Response: Rebuild MAKLIB from the MACRO source 
files and set feature switch FTBPT non-zero. 

7MKLCDM Existing code does not match original code 

Description: The original value you specified with either the 
.ALTER or .INSERT pseudo-op does not match the actual code at the 
location v you were attempting to change. 

Suggested User Response: First, determine if this is an error in 
the original value field of the pseudo-op. If this is actually 
the value you expected at that location, this error could 
indicate that you are trying to edit a different version of the 
library file. 

%MKLCII Code generated outside of range of .INSERT was ignored: 
[statement] 

Description: You entered a .FIX file with a sequence of code 

that was not included between .INSERT and .ENDI pseudo-ops. 

Suggested User Response: Change the .FIX file so that the 
instructions are within the range of an .INSERT. They can then 
be inserted in the module. 

%MKLCNF Insertion of edit [editl] by edit [edit2] conflicts with edit 
[edit3] 

Description: Edit2 contains a .REINSERT pseudo-op for editl. 

This conflicts with the .ASSOCIATED list in edit3 which is 
currently an active edit for this module. This is only a warning 
message, and the actual .REINSERT does take place. You can 
verify the current status of any edits with /TRACE. 

%MKLCNF Removal of edit [editl] by edit [edit2] conflicts with edit 
[edit3] 

Description: Edit2 contains a .REMOVE pseudo-op for editl. This 

conflicts with the .ASSOCIATED list of edit3 which is currently 
an active edit for this module. This is only a warning message, 
and the actual .REMOVE does take place. To verify the status of 
any edits, use /TRACE. 

7MKLCSR Command switch is required 

Description: You typed an incomplete command string. Supply 

additional information with file switches. 

Suggested User Response: Reissue the command string including 
the necessary switches on either the master library or 
transaction files. 
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7MKLEEI .ENDE seen before . ENDI in edit 

Description: Your .FIX file is missing an .ENDI pseudo-op, or 

the .ENDI pseudo-op is out of order. 

Suggested User Response: Make sure that each .INSERT pseudo-op 
is matched with an .ENDI pseudo-op to identify the code to be 
inserted. The .ENDE pseudo-op indicates the end of an edit. 
Therefore, it is always the last statement of an edit. 
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7MKLEFF End of file found before END block in module 

Description: The input master file is bad. Although part of the 

file is readable, the END block (REL Block type 5) is missing for 
the particular module. This indicates that the file is damaged. 

Suggested User Response: Re-create the file or restore it from a 
backup copy. 

%MKLEMA Entire MASTER file will be appended 

Description: For the current command string, the entire MASTER 

file is being appended to the output file even though you 
specified an individual module. 

?MKLEPM .EDIT pseudo-op is missing from FIX file 

Description: The .FIX file is incorrect. 

Suggested User Response: Change the .FIX file so that each edit 
begins^ with the .EDIT pseudo-op and ends with an .ENDE pseudo-op. 

7MKLERI Edit [edit] tried to .REMOVE or .REINSERT itself 

Description: The .FIX file contains an edit that has a .REMOVE 

or .REINSERT pseudo-op referencing itself. These pseudo-ops must 
reference edits that have previously been applied to the module. 

Suggested User Response: Change the .FIX file so that the 
.REMOVE or .REINSERT pseudo-op does not reference the current 
edit. 


7MKLETC MACRO code expression too complex at [location] (Edit [edit]) 


Description: The expression at the indicated location is too 

complex for MAKLIB to evaluate. 


Suggested User Response: Try to break the expression into 
several simpler expressions. 

7MKLETL ENTRY block is too large to read in for module [module] 

Description: MAKLIB does not have enough space allocated to 

process all the entry points for the specified module. 


Suggested User Response: Try to reduce the number of entry 
points in the module. 


7MKLFF4 Cannot apply FIX to F40 produced REL file 


Description: You attempted to apply a .FIX file to a .REL file 
produced by the F40 FORTRAN compiler. This operation is not 
supported by MAKLIB. F40 generates .REL files that MAKLIB cannot 
edit from .FIX files. 


7MKLFNI Qualifier ~F not implemented 

Description: MAKLIB does not support ~ F 

fixed-point decimal number. 

Suggested User Response: Enter the value in 


for entering 
an alternate form. 


a 
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7MKLFSI File status error on input [status] for file [file] 

Description: An error occurred while MAKLIB was reading the 

specified file. The status value that appears is described in 
this manual in Table 5-3. 

Suggested User Response: This could indicate a more global 
problem with the system. Refer to Table 5-3 in this manual to 
determine the specific problem with the named file. 

?MKLFSO File status error on output [status] for file [file] 

Description: An error occurred while MAKLIB was writing the 

specified file. The status value that appears is described in 
this manual in Table 5-3. 

Suggested User Response: This could indicate a more global 
problem with the system. Refer to Table 5-3 in this manual to 
determine the specific problem with the named file. 

7MKLIAA Illegal address in .ALTER in edit [edit] 

Description: In the specified edit, you used a .ALTER pseudo-op 

to change the contents of an address. However, you gave an 
illegal value for an address. 

Suggested User Response: Change the .ALTER pseudo-op so that is 
specifies a legal address. 

7MKLIAI Illegal address in .INSERT in edit [edit] 

Description: You specified an illegal address in the location 

field for a .INSERT pseudo-op. 

Suggested User Response: See if the address you specified is the 
address of a literal, external, or undefined address. These are 
not allowed. 

7MKLIAL .INSERT address is not in current module in edit [edit] 

Description: You specified an address in the location field for 

a .INSERT pseudo-op that is not in the specified module. 

Suggested User Response: First determine if the address you 
specified is the one you intended. Then check the .FIX file to 
verify that you placed the .INSERT sequences after the correct 
.MODULE pseudo-ops . 

7MKLIBT Illegal block type ([type]) was seen in file [file] 

Description: MAKLIB encountered an illegal REL Block while 

reading the indicated file. 

Suggested User Response: The .REL file being read may be 
damaged. Re-create the .REL file and try again. 

7MKLIED Internal error detected at [location] in MAKLIB 

Description: This indicates that MAKLIB cannot perform the 

operation you were attempting. 

Suggested User Response: Contact your Software Specialist or 
send a Software Performance Report (SPR) to DIGITAL. 
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7MKLIIA .INSERT pseudo-op illegal inside range of .INSERT [edit] 

Description: In the specified edit, you nested .INSERT 

psuedo-ops . 

Suggested User Response: These pseudo-ops cannot be nested. Use 
the . ENDI pseudo-op to end the first .INSERT sequence before you 
begin another. 

7MKLIII Illegal pseudo-op in range of .INSERT: [value] at [location] 
(edit [edit] ) 

Description: In your .FIX file you used a MACRO pseudo-op which 

is illegal in a .INSERT sequence. 

Suggested User Response: Verify that this is the correct MACRO 
pseudo-op for the operation you wish to perform. 

7MKLILS Illegal use of long string or BLOCK in .ALTER at [location] 
(edit [edit] ) 

Description: You tried to use a multi-word value with the .ALTER 

pseudo-op . 

Suggested User Response: The .ALTER pseudo-op is for changing 
single word values only. This applies to the original value as 
well as the new value. Use a separate .ALTER pseudo-op for each 
word to be altered. 


7MKLIPM .ENDI seen without .INSERT in edit [edit] 


Description: The .FIX file is incorrect. 

Suggested User Response: Change the .FIX file so that each set 
of instructions you wish to insert begins with an .INSERT 
pseudo-op and ends with an .ENDI pseudo-op. 


7MKLIRF Illegal relocation in FORWARD reference to [symbol] in edit 
[edit] 


Description: MAKLIB could not process the reference to the 

specified relocatable symbol. 

7MKLIRM /INSERT requires at least one /MASTER specification 


Description: The command string is incomplete. 


Suggested User Response: When you specify /INSERT on a 
transaction file, you must include /MASTER with the master file. 
You must supply a specification on /MASTER for every module you 
wish to insert. 


7MKLISM /INSERT, /REPLACE and /FIX are illegal switches on MASTER 
Description: The command string is incorrect. 

Suggested User Response: Reissue the command string putting 
/INSERT, /REPLACE, or /FIX on the transaction file. When you use 
/INSERT or /REPLACE, you must include /MASTER on the master file. 
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7MKLIST Interim symbol table overflowed, Code too complex in edit 
[edit] 

Description: Your specified edit contains code that has too many 

symbols for MAKLIB to process. 

Suggested User Response: Try to break the single edit into 
several edits, each having a fewer number of symbols. 

7MKLITS Insufficient TRACE block storage in edit [edit] 

Description: The specified edit exhausted all allocated storage 

for TRACE block information. 

Suggested User Response: Try to break the edit into several 
edits, thus reducing the amount of storage MAKLIB needs for TRACE 
blocks at any one time. For each edit, MAKLIB creates a TRACE 
block for each module that is changed. 

7MKLIUN Illegal to have null address in .INSERT in edit [edit] 

Description: In the specified edit, the location field of a 

.INSERT pseudo-op is null. 

Suggested User Response: The location field cannot be null. It 
specifies the location where you want to insert the patch code. 

%MKLLII Label outside of .INSERT was ignored: [label] 

Description: In a .FIX file you specified a label outside the 

range of a .INSERT. 

Suggested User Response: Change the .FIX file so that the label 
occurs within the range of an . INSERT- . ENDI pair. This specifies 
where you insert the new label in the program. 

7MKLLTL MACRO code line is too long at [location] (Edit [edit]) 

Description: In the specified edit, a line of code in the .FIX 

file is too long for MAKLIB to process. 

Suggested User Response: Try to reduce the length of the line by 
breaking it into several shorter lines. 

7MKLMCA Pseudo-operator argument error at [location] (Edit [edit]) 

Description: You gave an illegal pseudo-op argument. The values 

you can use depend on the particular pseudo-op. 

Suggested User Response: Supply a legal value for that 
pseudo-op . 

7MKLMCB MASTER device must be capable of binary 10 

Description: The input master file in your command string is not 

on a device that is capable of binary input/output. MAKLIB 
performs binary input/output on the master file. 

Suggested User Response: Keep the files you plan to use as 
MAKLIB master files on devices capable of binary input/output. 
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7MKLMCE Command error 

Description: MAKLIB was not able to recognize a valid command 

from the command string that you typed. This error could occur 
if you improperly formatted the command string or if you used a 
non-unique abbreviation to specify a switch. 

Suggested User Response: Retype the command string in the 
correct format: Destination File Spec=Source File 
Specl/Swi tches , Source File Spec2/Swi tches , . . .Source File 
Specn/Swi tches 

7MKLMCF Illegal forward or external reference at [location] (Edit 
[edit] ) 

Description: At the specified location you made a reference to 

an undefined symbol in this module. It could be a forward 
reference to a new symbol or it could be an external reference. 
MAKLIB cannot process forward references to new symbols. This 
error could also occur if you attempted to reference an existing 
symbol and supplied the wrong symbol name. 

Suggested User Response: Change your forward or external 
references to legal ones. 

7MKLMCM Attempt to redefine value of symbol [symbol] at [location] 
(Edit [edit] ) 

Description: You tried to redefine the value of an existing 

symbol. MAKLIB does not support this. 

Suggested User Response: You cannot use MAKLIB to change the 
value of an existing symbol. If this is not what you intended to 
do, you may be using a symbol that was already defined. Try 
another symbol. 

7MKLMCN MACRO code numeric error at [location] (Edit [edit]) 

Description: You supplied a numeric argument at the specified 

location that is illegal in that context. 

Suggested User Response: Supply a legal numeric value. 

7MKLMCQ MACRO code is questionable at [location] (Edit [edit]) 

Description: MAKLIB cannot process the code at the specified 

location . 

Suggested User Response: Check the code for legal MACRO syntax. 

7MKLMCR MACRO code relocation error at [location] (Edit [edit]) 

Description: The value at the specified location contains a 

half-word that is neither absolute nor simple relocatable. 
Expressions that would require Polish, such as A + A where A is 
relocatable, cannot be handled in MAKLIB. 

Suggested User Response: Give absolute or simple relocatable 
values only. 
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7MKLMCU Undefined symbol: [symbol] at [location] (Edit [edit]) 
Description: The symbol shown is not defined. 

Suggested User Response: Define the symbol. If you are trying 
to use a symbol that you think is already defined, check for the 
correct symbol name. 

7MKLMCW BYTE , EXP, DEC, or OCT more than one word at [location] (Edit 
[edit] ) 

Description: You used an expression that generates a multi-word 
value. In this context, MAKLIB supports only a single word 
value . 

Suggested User Response: Try to break the expression into 
simpler expressions, each generating a single word value. 

?MKLMEP Missing .ENDE for edit [edit] 

Description: The specified edit in your .FIX file is incorrect. 

Suggested User Response: Change the .FIX file so that each edit 
begins with the .EDIT pseudo-op and ends with an .ENDE pseudo-op. 

7MKLMFR Master file rejected by condition 

Description: The master file did not meet the condition you 

specified; hence processing cannot continue. 

7MKLMHE Module already has an edit [edit] 

Description: You attempted to apply an edit to a module that 

already has an edit with a similar identifier. 

Suggested User Response: Each edit to a module must have a 
unique identifier. You may have already applied this edit to the 
module . 

7MKLMKM [Pseudo-op] pseudo-op in edit [edit] without preceding .MODULE 

Description: In the specified edit, you gave a pseudo-op out of 

order. It applies to a specific module that you must specify 
with a preceding .MODULE pseudo-op. 

Suggested User Response: Make certain that a .MODULE pseudo-op 
precedes those pseudo-ops that refer to a specific module. 

7MKLMNF Module [module] was not found in file [file] 

Description: MAKLIB cannot find the specified module in this 

file. If you are trying to apply a .FIX to a master library, you 
may have specified a non-existent module name on a /MODULE 
pseudo-op. You can also receive this error when you perform an 
operation that does not involve .FIX files. You may have 
specified several module names and supplied them out of order. 
The module in question may be in the file. But since MAKLIB 
processes files in a sequential manner, it will not find all 
modul es . 

Suggested User Response: Use /LIST to see if the specified 
module is really in the library. If not, you cannot perform this 
function. 
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iMKLMNI /MASTER module names are ignored when patching. 

Description: For editing, the correct way to specify module 
names is with the .MODULE pseudo-op in the .FIX file. /MASTER is 
not reguired for this type of command. MAKLIB ignores it. 
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?MKLMTF /MASTER switch cannot be used on transaction file 
Description: The command string is incorrect. 

Suggested User Response: Retype the command string with the 
switch in the correct place. Include only /MASTER on the master 
file. 

7MKLNEA Not enough arguments specified 

Description: The command string is incomplete. This error 

usually means that you omitted a required file spec. 

Suggested User Response: Retype the command string in the 
correct format: Destination file spec=Source file 
specl/Swi tches , Source file spec2/Swi tches .. .Source file 
specn/Swi tches 

7MKLNEC Not enough core is available 

Description: MAKLIB cannot obtain enough memory to process this 

command . 

Suggested User Response: Break the .REL files into smaller 
numbers of modules, or break large modules into smaller modules. 

7MKLNEI Null argument to .EDIT is illegal 

Description: You did not specify an edit identifier on the .EDIT 

pseudo-op . 

Suggested User Response: Each .EDIT pseudo-op requires an 
argument (up to 6 characters) that identifies the edit. 

%MKLNIO Output file [file] will not be indexed 

Description: The output file will not include an index. To add 

an index to the file, issue a separate MAKLIB command with 
/INDEX. 

7MKLNMS Null specification to .MODULE [edit] 

Description: In your edit, you included a .MODULE pseudo-op 

without the module name. 

Suggested User Response: Correct the .FIX file by supplying a 
module name on each .MODULE pseudo-op. 

7MKLNPC No program code was found for module in edit [edit] 

Description: You have specified a non-existent module in the 

master file. 

7MKLNPS No program names were specified for file [file] 

Description: You tried to manipulate some of the modules in the 

specified file, but you did not supply any module names. 

Suggested User Response: In order to /EXTRACT or /DELETE modules 
from a file, supply the module name on the file switch. 
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7MKLNRP Not a recognized position switch: [value] 

Description: You gave an illegal position indicator on an 
.INSERT pseudo-op. 

Suggested User Response: Use one of the three legal position 
indicators: BEFORE, AFTER, or REPLACE. 

7MKLNTM Not enough TRANSACTION modules were specified 

Description: You did not supply enough replacement module names 

to perform the /REPLACE operation. 

Suggested User Response: When you give the MAKLIB command 
string, make certain that there is a corresponding replacement 
module for each module you intend to replace in the master 
1 ibrary . 

7MKL0DD Output device must be DISK or DECTAPE 

Description: In your MAKLIB command, you specified an illegal 

output library device. 

Suggested User Response: Retype the command string and use disk 
for the output device of the library file. 

7MKLPEF Premature end-of-file during edit [edit] in file [file] 

Description: While processing the indicated edit, MAKLIB 
encountered an unexpected end of file in the .FIX file. This 
error usually occurs when you omit the .ENDE pseudo-op. 

Suggested User Response: Check the .FIX file for errors, and 
look especially for .ENDI and .ENDE pseudo-ops. 

%MKLPEP Precluded edit [edit] is present in module 

Description: The module you are editing contains an active edit 

that your current edit precludes with the .ASSOCIATED pseudo-op. 
MAKLIB still applies your edit. 

%MKLPES Purging EXTERNAL symbol [symbol] may give bad REL file 

Description: One of the symbols that this edit PURGEd from the 

symbol table was an EXTERNAL symbol. With this symbol removed, 
it may not be possible to LINK the file correctly. 

PMKLRBF REQUEST or REQUIRE block is badly formatted 

Description: In the master library being processed, MAKLIB 

encountered a REQUEST block (REL Block type 17) or REQUIRE block 
(REL Block type 16) that was not in the expected format. 

Suggested User Response: The library file may be damaged. Try 
to rebuild it. 

%MKLREM Required edit [edit] is missing from module 

Description: The module you are editing is missing an active 

edit that your current edit requires with the .ASSOCIATED 
pseudo-op. MAKLIB still applies your current edit. 
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%MKLRER Required edit [edit] is inactive in module 

Description: The module you are editing contains an inactive 
edit that your current edit requires with the .ASSOCIATED 
pseudo-op. MAKLIB still applies your current edit. 

%MKLRIA Edit [edit] tried to .REINSERT already active edit 

Description: Your current edit contains a .REINSERT pseudo-op 

that attempts to activate an edit that is already active. 

%MKLRIE Edit [edit] tried to .REMOVE already inactive edit 

Description: Your current edit contains a .REMOVE pseudo-op that 

attempts to deactivate an edit that was previously deactivated. 

%MKLRIN Edit [edit] tried to .REINSERT non-existent edit 

Description: Your current edit contains a .REINSERT pseudo-op 

that attempts to activate a non-existent edit. 

%MKLRNE Edit [edit] tried to .REMOVE non-existent edit 

Description: Your current edit contains a .REMOVE pseudo-op that 

attempts to deactivate a non-existent edit. 

7MKLRTL .INSERT'S REPLACE argument of [value] too large for module 
[module] 

Description: On an .INSERT pseudo-op you specified a number of 

instructions to be replaced. This number exceeds the number of 
instructions in the module beyond the starting replacement 
address . 

Suggested User Response: Correct the argument to the REPLACE 
keyword on the .INSERT pseudo-op. 

7MKLSCE Storage for patch code was exhausted in edit [edit] 

Description: MAKLIB allocates a fixed amount of space for 
processing the new code inserted from a .FIX file. Your .FIX 
file contains more code than MAKLIB can process in the allocated 
space . 

Suggested User Response: Try to break your .FIX file into 
several .FIX files with fewer lines of new code. 

7MKLSI0 Switches are illegal on output 

Description: The command string is incorrect. Switches are not 

recognized on the output file. 

Suggested User Response: Retype the command string including any 
necessary switches with the appropriate input files. 

%MKLSNF Symbols not found for module 

Description: There are no symbols in the master file for the 

module that you wish to edit. 
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7MKLSSE Storage for patch symbols was exhausted during edit [edit] 

Description: MAKLIB allocates a fixed amount of storage for 

processing the new symbols from .FIX files. Your .FIX file 
contains more symbols than MAKLIB can process in the allocated 
space. 

Suggested User Response: Try to break your .FIX file into 

several .FIX files with fewer symbols. 

%MKLTBF TRACE block is badly formatted in module 

Description: One of the TRACE blocks (REL Block type 1060) for 

this module is not in the expected format. The .REL file may be 

damaged. Since the loader ignores trace blocks when reading a 

file, you may still be able to load from this .REL file. 

%MKLTFI Transaction file ignored 

Description: You included a transaction file in the command 

string to create an indexed library. 

Suggested User Response: You must create the indexed library as 
a single operation. If there are several operations you must 
perform on the library, the command to index the library should 
be the last command that you issue. 

7MKLTFR All transaction files rejected by condition. 

Description: Processing cannot continue because the transaction 

files did not meet the condition you specified (as size, creation 
da te , e tc . ) . 

7MKLTMN Too many module names . . . stopped at [module] 

Description: The command string is too long. 

Suggested User Response: Retype the command string as several 
shorter commands. It is unlikely that this message will appear, 
since MAKLIB now allows up to 100 switch arguments for each 
command string. 

7MKLTMS Too many switches 

Description: You included too many switches on a file spec. You 

specified some of the switches in an illegal combination. 

Suggested User Response: Retype the command string in a correct 
format. 

7MKLUDF Module [module] in edit [edit] contains undefined symbol (s) 

Description: Your current edit contains undefined symbols in the 

indicated module. 

Suggested User Response: Make certain that all new symbols 
introduced in your .FIX file have values associated with them. 

7MKLWIO Wild cards illegal for output file specification 

Description: You gave an output file name in the command string 

that included wildcard characters (either * or 7) . 

Suggested User Response: Since wildcard characters are illegal 
for the output file name, retype the command string with an 
explicit output file name. 
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7SCNSVR Switch value required on [switch] 

Description: The specified switch requires a value. 

Suggested User Response: Retype the command string and supply a 
value for the switch. The format for providing a value is 
/switch:value or /switch: (valuel , value2) . 

7WLDLKE Protection failure file [file] 

Description: The specified file is protected. You do not have 

the privileges to access it. 

Suggested User Response: If this is the output file, you need 
privileges to create a file in the directory you specified. If 
it is an input file, you need privileges to read that file from 
that particular directory. 

7WLDLKE Non-existent file [file] 

Description: The specified file does not exist. 

Suggested User Response: This error usually occurs when the name 
of an input file is incorrect. Retype the command string with 
the correct input file name. 


6.5 TECHNICAL NOTES 

The following is supplementary information related to editing 
libraries with MAKLIB. Section 6.5.1 describes TRACE blocks (REL 
Block type 1060). Section 6.5.2 contains the format for code 
insertion in .FIX files. 


6.5.1 Format of TRACE Block Data (REL Block Type 1060) 


MAKLIB uses the TRACE block to include, in the .REL file, information 
for verifying and changing the patch status of a program. The format 
of the TRACE block follows. 


The first part of the TRACE block is the static area, 
appears in each module affected by the particular edit, 
areas give information common to all modules affected by an 
the variable gives the changing data on the particular edit 
from module to module. 


This area 
The static 
edit and 
as it goes 


TB$HED 

REL Block Type 

Length of Block 

TB$EDT 

SIXBIT Edit Name 

(Up to 6 chars.) 

TB$STA 

-1 If Active 

Who Last Affected 

TB$MAK 

Who Created 

Date (15 BIT) 

TB$ INS 

Who Installed 

Date (15 BIT) 

TB$FUT 

Reserved for Future Use 

TB$LEN 

# of Assoc. Edits 

# of PCO Groups 
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The static area, which repeats in each module, is followed by a 
variable area. The variable area consists of two parts. The first 
gives data on the associated edit status for this module, and the 
second gives the actual program change orders (PCO's). The length of 
each of these areas appears in the static area of the TRACE block. 

For each associated edit, the following group appears: 


TB$AEN 


SIXBIT Edit 

Name of Assoc. Edit 

TB$AES 

X 

Reserved 

for Future Use 


0B0 

1B0 


If can't be present 
If must be present 


After the associated edit groups appear (if there are any), the PCO 
groups for that module appear. There are currently three types of 
program change groups: INSERT, REMOVE, and REINSERT. They can appear 
in any order and the total number is variable. 


TB$PCO 


TB$DAT 


TB$PAT 


INSERT PCO: 


PCO Type Code (1) 

Length of Group 

Instrs. INSERTed 

Addr. of INSERT 

New Addr. of Original Code 

Addr. of Patch Code 


REMOVE PCO: 


TB$PCO 

PCO Type Code (2) 

Length of Group 

TB$REN 

SIXBIT Edit Name 


RE-INSERT PCO: 


TB$PCO 

PCO Type Code (3) 

Length of Group 

TB$RIN 

SIXBIT 

Edit Name 


TB$PCO 

TB$DAT 

TB$PAT 


ALTER PCO: 


PCO Type Code (4) 

Length of Group 

Unused 

Addr. of ALTER 

New Addr. of Original Code 

Unused 
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6.5.2 Format of Code Insertion 

The four formats of code insertion in a .FIX file are shown here. 
Notice that, in all cases, the patch ends with exactly two JUMPA 
instructions. Thus, the last instruction of the patch can at most 
skip a single instruction and still return control to the original 
code . 

To INSERT any instruction or series of instructions (code) BEFORE a 
location, use this format: 

.INSERT location, BEFORE, <original instruction> 


LOCATION: 


%PATCH : 


JUMPA %PATCH 


First Patch Instruction 


Second Patch Instruction 


Last Patch Instruction 


Original Patch Instruction 
JUMPA 1, LOCATION+1 


JUMPA 2, LOCATION +2 


Any "Literals" 


The actual label created at the location of the patched-in code is 
of the form: 

"%"< edit-name ><edit-part> 

where the edit-part is from "A" to "Z" , incremented for each .INSERT 
in the edit. 
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To INSERT any instruction or series of instructions (code) 
location, use this format: 

.INSERT location, AFTER, <original instruction> 

LOCATION: 

%PATCH : 


To REPLACE a single instruction, use the format: 

.INSERT location, REPLACE, Coriginal instruction> 


LOCATION: 


%PATCH : 


If you do not insert instructions (n=0) , then the return is 
LOCATION+1 and LOCATION+2. 


JUMPA %PATCH 


Original Instruction 


First Patch Instruction 


Second Patch Instruction 


nTH (Last) Patch Instruction 


JUMPA 1, LOCATION+n 


JUMPA 2, LOCATION+n+1 


Any "Literals" 


JUMPA %PATCH 


Or iginal Instruction 
First Patch Instruction 


Second Patch Instruction 


Last Patch Instruction 


JUMPA 1, LOCATION+1 


JUMPA 2, LOCATION+2 


Any "Literals" 


AFTER a 


to 
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To REPLACE more than one instruction at a location, use the format: 

.INSERT location REPLACE :m Coriginal instruction> 

LOCATION: JUMPA %PATCH 

Original Instruction 

%PATCH : First Patch Instruction 

Second Patch Instruction 

Last Instruction of Patch 
JUMPA 1, LOCATION+m 
JUMPA 2, LOCATION+m+1 
Any "Literals" 

If you do not specify m, or it is zero, the effect is the same as the 
REPLACE keyword without an argument. In other words, one word is 
skipped over on return for every one inserted. 
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CHAPTER 7 


THE DUMPER PROGRAM 


7.1 INTRODUCTION 

DUMPER is a TOPS-20 utility program used to save files on magnetic 
tape, and later to restore any or all of these files to a specified 
directory on disk. DUMPER is available to both nonpr ivileged and 
privileged users. (Throughout this chapter, the term "operator" is 
occasionally used instead of privileged user.) As a nonpr ivileged 
user, you can use DUMPER to save your own files or any files to which 
you have access, by transferring them from the disk area to a 9-track 
magnetic tape (DUMPER does not function on a 7-track magnetic tape 
drive), and later restoring them to disk. As a privileged user, you 
can use DUMPER to: 

@ save other users* files 

® back up the system files (copy all files onto tape for an 
indefinite period of time) 

© archive users' files (copy files marked for storage onto tape 
and delete them from disk) 

© migrate users' files (copy files onto tape and delete them 
from the disk) to create added disk space 

® retrieve previously migrated or archived files. 

The length of time files remain on tape is determined by each 
installation. In general, however, archived files are kept longer 
than backup files. Archiving is voluntary on the part of the 
nonpr ivileged user; migrating is not. 

Sections 7.2 through 7.4 describe the functions of DUMPER, the use of 
tapes, and the procedure to run DUMPER. Sections 7.5 and 7.6 describe 
the commands available to both the nonpr ivileged and privileged user. 
Examples are provided to illustrate the use of each command. Included 
in the examples are error messages that might occur with a particular 
command. Section 7.7 contains an alphabetical list of all commands. 
Section 7.8 contains an alphabetical list of all error messages. 
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Before continuing , you should know the following terms: 

JFN Indicates a job file number, an octal 

number that represents a particular 
file. 

saveset Indicates a group of files on tape 

stored as the result of one SAVE command 
to DUMPER. 

saveset name Indicates a string of up to 30 

alphanumeric characters used as the name 
for a saveset. The specified name is 
written in the saveset header on the 
tape. 

tape set Indicates a set of one or more volumes 

(reels) of tapes grouped under a single 
name. Each tape is distinguished by a 
unique identification of up to six 
alphanumer ic characters. 


NOTE 

As mentioned at the beginning of this 
manual, it is assumed that you are 
familiar with TOPS-20 log-in procedures 
and the basic commands. To understand 
DUMPER, you should be particularly 
familiar with the following commands: 
MOUNT TAPE, DISMOUNT TAPE, DEFINE, 
ASSIGN, and INFORMATION. (Refer to the 
TOPS-2Q Commands Reference Manual. ) 


7 . 2 FEATURES 

The following is a list of DUMPER's most useful features. 


• With DUMPER, you can specify particular files to be 
transferred between disk and tape. For example, you can 
specify files using the standard TOPS-20 file spec format of 
dev : <dir >name . typ.gen and/or you can select files based on the 
dates and times that the files were created, modified, or 
accessed. Other conditions can also be set; if the file 
meets all conditions, it is transferred. (Refer to Section 
7.5.1.) 

© You can save a set of files that exceeds one reel of magnetic 
tape. If all files specified cannot fit on one tape, DUMPER 
continues the operation on subsequent tapes (except in 
INTERCHANGE mode, which allows only one tape) . 

• You can recover from a system crash during a save or restore 
operation without restarting at the beginning. (You do this 
by adding an additional reel of tape, and using the INITIAL 
command. Refer to Section 7.5.1.) 
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® As a privileged user, you can transfer files marked for 
archival by another user. This ensures that those files are 
saved for a period of time (determined by each installation) 
for future use or reference. 

* As a privileged user, you can migrate files that have not been 
referenced within a specified period of time (as defined by 
each installation) . 

® As a means of verification, you can request that filenames, 
directory names, and saveset names be printed during save and 
restore operations. 

e DUMPER can read and write tapes written under older versions 
of DUMPER. Section 7.3 describes the use of tapes with both 
Version 4 and previous versions of TOPS-20 DUMPER. 


7.3 USING TAPES WITH AND WITHOUT TAPE DRIVE ALLOCATION 

Before running DUMPER, you must have a tape mounted. With Version 4 
of TOPS-20, your installation may be using tape drive allocation; 
with previous versions, tape drive allocation does not exist. Tape 
drive allocation allows you to request a tape to be mounted; TOPS-20 
fulfills that request with any free drive. The absence of tape drive 
allocation requires that you assign a specific tape drive yourself. 
If you are using unlabeled tapes, tape drive allocation has no effect 
on the content of the tapes that DUMPER writes. If you are using 
labeled tapes, tape drive allocation is required. The label 
information on the tape then helps to identify the tape without 
operator intervention. Tape drive allocation also allows you to read 
tapes written under versions of DUMPER previous to Version 4 of 
TOPS-20 . The difference between the presence or absence of tape drive 
allocation is in the method of mounting and dismounting tapes, and the 
fact that you cannot read or write labeled tapes without tape drive 
allocation. A description of each method follows. 


NOTE 

You can determine whether your 
installation is using tape drive 
allocation by typing the TOPS-20 command 
INFORMATION SYSTEM-STATUS. 

©INFORMATION (ABOUT) SYSTEM-STATUS C^D 
Operator is in attendance 
E e iyi o t e 1 o g i n a a 1 1 a w e d 
L o e a 1 1 o g i n s a 1 1 o w e d 
P a e u d o - 1 e r m i n a 1 1 o g i n s a 1 1 o w e d 
A R P A N E T t e r m i n a 1 1 o g i n a a r e n o t a 1 1 o w e d 
C o n a a 1 e t e r m i n a 1 1 a g :i. n a 1 1 o w e d 
Accounting is being done 
A c c o u n t v a 1 i d a t i o n i a e n a b 1 e d 
T a p e - d r i v e a 1 1 o c a t i o n i a e n a b 1 e d 
A u t o in a t i e f i 1 e - r e t r i e v a 1 - w a i t a a 1 1 o w e d 
S c bed u 1 e r b :i. a a • • c o n t y' o 1 a e 1 1 i n g i a 1 :L 
Class a c h e d u 1 i n g b a a c c o u n t a e n a b 1 e d v 
windfall allocated? batch claaa 1 

6 
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If your installation does not have tape drive allocation, use a tape 
as follows: 


• Select a tape drive (for example MTA1 : ) and type the TOPS-20 
command ASSIGN MTAl : . 

• The system responds with MTAl: ASSIGNED. 

• Mount the tape on the assigned drive. 

• Run the DUMPER program to perform your tape operations. First 

identify the assigned tape by typing the DUMPER command TAPE 
MTAl: in response to the prompt, DUMPER> . If you omit the 

command, DUMPER looks for a device that has been defined as 
MTA-DUMPER:. To define the logical name MTA-DUMPER: as your 
assigned tape drive (and thereby save a step after entering 
DUMPER), perform the following steps: 


• Assign a tape drive. 

©ASSIGN MTAl :C“D 

• Define that drive as MTA-DUMPER: 

©DEFINE MTA-DUMPER: MTAl 

• Upon completion of tape operations, exit from DUMPER. 

• Type the TOPS-20 commands UNLOAD MTAl: and then DEASSIGN 

MTAl:. Remove the tape from the drive. 


If your installation is using tape drive allocation (under Version 4 
of TOPS-20), you mount a tape as follows: 

• Type the TOPS-20 command MOUNT TAPE name:. The name (for 
example, TAPE 1 : ) is a logical name. The system responds with 
a message indicating that your request is in queue. For 
example: 

©MOUNT TAPE TAPE1 : / U R ITE-ENAB L E DGllD 

i M a u n t R g a u e s t T A P E 1 Q u e u e d v R e a u e s t - 1 D 1 7 A "I 


NOTE 

By typing /WRITE-ENABLED as part of the 
MOUNT TAPE command, you can write onto 
the tape. If you do not specify this 
switch, you can do only read operations 
(i.e., print a list of filenames or 
restore files to disk) . 


If your installation requires that the tape be mounted by an 
operator, the tape reel must have an external identification 
label with the specified name clearly visible to the operator. 
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NOTE 

If your tape has never been initialized, 
be sure to tell the operator. He must 
initialize the tape before you can use 
it . 


• Either you or the operator (depending upon the procedure at 
your installation) mounts the tape on any available drive. If 
the tape is an unlabeled tape, it must be identified to the 
system. (Refer to the TOPS-20 Operator's Guide .) 

© The tape is then known to the system, and the system assigns a 
tape device number. You receive a message such as: 

C M o u n 1 R e a u e s t T A F : ' E 1 Q u e u e d ? R e « u e s t - I D :L 1 4 3 
f Tape set T APE 1 y volume TAPE! mounted 1 
r TAREK defined as MT 0 l II 

® Run DUMPER to perform your tape operations. 

® Upon completion of tape operations, exit from DUMPER. 

e Type the TOPS-20 command DISMOUNT TAPE name: where the name 
is the same logical name used with the MOUNT TAPE command. 

® The system responds with: 

I” T a p e d :i. s m o u n t e d v 1 o A i c a .1. n a m e T A P E 1 ♦ d e 1 e t e d II 


To assign the logical name MTA-DUMPER: before entering DUMPER, define 
the logical name using your tape name or the tape drive number you 
were assigned: 

©DEFINE MTA-DUMPER 5 TAPE1 iCHD 
or 

(» ti E FINE M T A - D UMPE R J M T r. : 

DUMPER supports both unlabeled and TOPS-20 and ANSI labeled tapes. It 
is not necessary to specify which you are mounting. However, in case 
there is a duplication of set name or identification between labeled 
and unlabeled tapes, it is wise to be specific. This avoids confusion 
for the operator mounting your tapes. For example, you can append a 
label-type switch to the MOUNT TAPE command: 

©MOUNT TAPE TAPE It /LABEL.. -TYPE t UNLABELED /URITE-ENABLEDCkD 
or 

©MOUNT TAPE TAPElt /LABEL-TYPE t T0PS--20 /URITE-ENABLEDCsD 

If you think you need more than one tape, you can identify all the 
tapes in advance by adding another switch to the MOUNT TAPE command: 

/VO LIDS :volidl,volid2, . . . ,volidn 

If you use /VOLIDS:, the name you give with the MOUNT TAPE command now 
refers to the entire tape set. The specifications volidl through 
volidn (for example, DH33, DH44, DH55)) identify each volume of tape 
within the set. Each volume identifier (volid) can be one to six 
alphanumer ic characters. 
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When you type the MOUNT TAPE command, the system requests that the 
first volume of the set be mounted. When the operator has done this, 
you receive a message, such as: 

1“ T a p e s e t T A F : ' E 1 v v o 1 u m e D 1-1 3 3 iri o u n ted ."I 
I” T A P E 1 t d e f i n e d a s M T 0 t .‘1 

If you wish to read the tape set, you must specify the volumes in the 
order in which they were written. You can begin with any volume in 
the set, but you cannot then specify a tape with a volid previous to 
the one with which you began. For example, if you wrote the tapes in 
the order DH33, DH44, DH55, you can request: 

/V0LIDS:DH44*DH55 

You cannot, however, request volumes DH44, DH33 nor omit a volid by 
requesting volumes DH33, DH55. 

When the first volume is mounted, you are ready to run DUMPER. 


NOTE 

If your write operations require more 
than the specified number of tapes, 
DUMPER automatically requests the 
operator to mount an additional tape. 
When the operation is complete, you can 
verify the additional tape in your set 
by typing the TOPS-20 command 
INFORMATION (ABOUT) VOLUMES name: 
before you type the DISMOUNT command 
(where name: is the name of the tape 
set) . The system responds with the 
volid of each volume. 


©INFORMATION (ABOUT) VOLUMES (OF TAPE) TAPE1 tC^D 
Volumes of tape set TAPE It DH33>DH44/DH55>DH56 
© 


7.4 RUNNING DUMPER 

To run DUMPER, type DUMPER and press RETURN in response to the TOPS-20 
prompt @. DUMPER prompts with its name and a right angle bracket (>): 

©DUMPERQID 

DUMPER> 


NOTE 

The examples in this chapter assume use 
of unlabeled tapes and tape drive 
allocation enabled . 


As with TOPS-20 commands, you can type DUMPER commands in full, 
abbreviated, or recognition mode. Also, you must terminate all DUMPER 
commands by pressing RETURN. 
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To leave DUMPER and return to TOPS-20 command level, type either QUIT 
or EXIT: 

DUMPER > EXITQID 
0 


7.5 THE NONPRIVILEGED USER 

As a nonpr ivileged user, you can use DUMPER to save and restore your 
own files, or any other files to which you have access. 

The DUMPER commands to which you have access can be classified into 
three categories: 

1. Status-Setting commands, which set parameters affecting 
future operation of action commands. 

2. Tape-Positioning commands, which control the position of the 
tape . 

3. Action commands, which start, stop, interrupt, or continue a 
file transfer or file check. 

Sections 7.5.1 through 7.5.3 describe the commands in each category. 
Each section includes command formats and examples. Where applicable, 
command complements are included in the description. The complement 
of a command negates the command, and is formed by preceding the 
command with NO. 


7.5.1 Setting the Status of Operation 

The Status-Setting commands set parameters that affect the operation 
of the Action commands CHECK, RESTORE, RETRIEVE, and SAVE (refer to 
Section 7.5.2). Once you have set a parameter, it remains in effect 
until you change it or restart DUMPER. If you specify multiple 
conditions, the file you wish to transfer must satisfy all conditions 
to be transferred. 

Two parameters associated with these commands are date and time. The 
date can be specified in any standard American or European format such 
as: 16-May-79, 5/16/79, etc. The time can be specified either in 
24-hour format or in AM/PM format. For example 7:23 in the evening 
can be specified as 19:23 or as 7:23pm. 

For a printed explanation of all DUMPER commands, run DUMPER and type 
HELP, followed by RETURN. This lists and briefly describes all DUMPER 
commands, and lists required arguments. 

Table 7-1 lists all Status-Setting commands according to their 
functions. A detailed description of each command follows the table. 
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Table 7-1 

Status-Setting Commands 


Function 

Commands 

Specifying the selection of 
specific files 

BEFORE, ABEFORE 

MBEFORE, SINCE, 

ASINCE, MSINCE, 

SUPERSEDE 

Specifying the printing 
(or suppressing) or storing 
of file or directory names 

DIRECTORIES, FILES ! 

LIST, SILENCE 

Specifying disk file 
characteristics 

ACCOUNT, PROTECTION 

Specifying the tape 
characteristics 

DENSITY, FORMAT, 
INTERCHANGE, PARITY, 

TAPE, INDUSTRY, 

SET BLOCKING-FACTOR, 

SSNAME 

Specifying checksums to be included 
when a list of saved files 
is printed 

CHECKSUM 

Specifying the continuation 
of interrupted savesets 

SET TAPE-NUMBER, 

INITIAL 


The descriptions and examples below are divided into sets according to 
the functions described in Table 7-1. The first set describes the 
selection of files to be transferred on the basis of date and time, 
and according to name, type and generation. 

The format is the same for all BEFORE and SINCE commands. Below is a 
description of each, followed by examples of four of the commands. 


BEFORE (DATE AND TIME) date time 

The BEFORE command transfers only files whose last user written 
date is before the date and time specified. The last user 
written date is the most recent time the user changed the actual 
data of the file. This date is recorded in the . FBWRT entry of 
the FDB , and is preserved when the file is copied. 


NOTE 

If time is omitted, the default is 

00 : 00 : 01 . 


ABEFORE (DATE AND TIME) date time 

The ABEFORE command transfers only files whose last user access 
is before the date and time specified. The last access date is 
the most recent time the file was typed, printed, or read, but 
not modified. This date is recorded in the . FBREF entry of the 
FDB. 
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MBEFORE (DATE AND TIME) date time 

The MBEFORE command transfers only files whose last system write 
date is before the date and time specified. The last system 
write date is the most recent time the file was physically 
changed on disk. This change includes copying the file. The 
date is recorded in the . FBCRE entry of the FDB , and is not 
settable by a nonpr ivil eged user. 


NOTE 

Refer to Table 7-4 for a description of 
FDB entries that affect DUMPER. 


SINCE (DATE AND TIME) date time 

The SINCE command transfers only files whose last user written 
date is later than the date and time specified. The last user 
written date is the most recent time the user changed the actual 
data of the file. This date is recorded in the . FBWRT entry of 
the FDB , and is preserved when the file is copied. 


NOTE 

If time is omitted, the default is 
00 : 00 : 01 . 


ASINCE (DATE AND TIME) date time 

The ASINCE command transfers only files whose last user access is 
later than the date and time specified. The last access date is 
the most recent time the file was typed, printed, or read, but 
not modified. This date is recorded in the . FBREF entry of the 
FDB. 


MSINCE (DATE AND TIME) date time 

The MSINCE command transfers only files whose last system write 
date is later than the date and time specified. The last system 
write date is the most recent time the file was physically 
changed on disk. This change includes copying the file. The 
date is recorded in the .FBCRE entry of the FDB, and is not 
settable by a nonpr ivil eged user. 


Exampl es : 

1. DUMPER> BEFORE (DATE AND TIME) 5/18/79 8:00AMC«D 

transfers only files created, or whose contents were 
modified, before 8:00 A.M. on May 18, 1979. 

2. DUMPER> ABEFORE (DATE AND TIME) 18-MAY-79 17J0()CmD 

transfers only files accessed by a non-write operation (i.e., 
those that were typed, printed, or read) before 5:00 P.M. on 
May 18, 1979. 
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3. DUMPER>MSINCE (DATE AND TIME) MAY-1-79 8t30C^P 

transfers only files that have been system modified (for 
example, copied) since 8:30 A.M. on May 1, 1979. 

4. DUMPER>SINCE (DATE AND TIME) 4-29-79 CUT) 

transfers only files that have been created or changed since 
the first minute of April 29, 1979. (Because no time was 
specified, the default is one minute after midnight.) 

The SUPERSEDE command sets the condition under which DUMPER overwrites 
a disk file with a magnetic tape file of the same name and type. You 
must specify one of the following conditions: 

1. ALWAYS - when you want the tape file to overwrite the disk 
file of the same name and type regardless of the date or 
generation number of the disk file. If the disk file has a 
higher generation number, DUMPER restores the file from tape 
to disk, giving the disk file a generation number one higher 
than that existing currently. If the disk file has a lower 
generation number, DUMPER overwrites the disk file using the 
generation number of the file on tape. (Refer to the example 
below . ) 

2. NEVER - when you do not want the tape file to overwrite the 
disk file under any circumstances. In this case, a file is 
transferred to disk only if there is no file on disk with the 
same name and type. 

3. OLDER - when the date that the tape file was last modified 
(created, read, written) is more recent than the date of the 
existing disk file with the same name and type. In that 
case, the tape file replaces the disk file. If the SUPERSEDE 
command is not specified, DUMPER assumes SUPERSEDE OLDER. 


Example: 


(» V D I E E C T 0 R Y ( 0 F F I L E S ) F I LEI ♦ R N O C^D 
MI8C X CHUTCH INS> 

F I L E 1 ♦ R N 0 ♦ 1 5 P 7 7 7 7 0 0 2 3 .1. 5 5(7) 2 - ,J U L - 7 9 15 1 5 1 1 3 6 

©dumper r^T) 
dumper>rewindQsD 

D U M P E E > S IJ P E R S E D E A L W A Y SQED 
IiLIMPER>FILESQeT) 

D U M P E R > RESTORE (TAPE FILES) FILE! ♦ RNOQeT) 


DUMPER tape # 1 Vo lid TAPE If f Tuesday? 3-Jul-79 1126 
L o a d :i. n f i 1 e ( s ) i n t o M I S C t < H IJ T C H I N S > 

M I S C t < H IJ T C H I N S > F I L E 1 ♦ RNO ♦ 1 $ P 7 7 7 7 0 0 ? A 3 4 1 ( T 0 ) FI L E .1. ♦ R N 0 ♦ 3 C 0 K 1 

E n d o f s a v e set 
DUMPERS EX I TCED 

©DIRECTORY (OF FILES) FI LEI ♦ RNOQil) 

MI SC ♦ CHUTCH I NS> 

FI LEI ♦ RNO ♦ 3 

© 
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The commands to activate or deactivate printing are similar. The 
defaults, however, are different, as described below. 


DIRECTORIES 

Normally, DUMPER prints directory names on your terminal as it 
saves or restores them. For example. 


0 DUMPER f^T) 

D U M P E R > T A P E ( D E V I C E ) T A P E 1 :G"D 

dumper>rewind(«D 

DUMPER> SAVE (DISK FILES) MI SC :<*>QID 

DUMPER tape # 1 Valid SET2> r Tuesday* ll-Sep-79 0850 
MISC ♦ <ADLEY> 

MISC:<APLB> 

MISC ♦ <APLSF> 

MISC* < BAKE R > 

MISC t <BATGR> 

MISC:<BELANGER> 


To suppress printing, type NO DIRECTORIES before the SAVE or 
RESTORE command. This is useful if you are a privileged user 
performing backup of files on many directories. For example, 

D U M P E R > N 0 D I R E C T 0 R I E S C^T) 

PUMP ER> SAVE (DISK FILES) PS :*•*♦* y MISC :*♦*♦ * (AS)-Ch D 
DUMPER tape - # 1 Valid TAPE! y 9 Tuesday y 3-Jul-79 1131 


T o t s 1 f i 1 e s d u m p e d « 1 1 A 3 
Total pa&es dumped :: = 4293 
DUMPER> 

As all files in all directories on the structures PS: and MISC: 
are saved on tape, DUMPER does not print the directory names on 
the terminal. 

To reactivate printing before the next transfer operation, type 
DIRECTORIES in response to the DUMPER prompt. 


FILES 


Normally, DUMPER does not print a list of file specs as it is 
saving or restoring them. You see only the name of the structure 
and directory, and the number of total files and pages 
transferred. For the file specs to print on your terminal, type 
FILES before the SAVE or RESTORE command. 
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Example: 


eiiUMFER fjST) 

D U M P E R > T APE ( D E V I C E ) T A P E 1 

dumper>rewindC«D 

D U M P E R > D I R E CTO R I E SQeD 
PUMPER>FILESr5D 

DUMPER> SAVE ( D I SK F I LES ) PS J * * * ♦ * * MISC * *♦ * ♦ * < AS KjllD 
DUMPER tape # 1 Valid TAPE ! v y Thu rsdsy* 5-Jul-79 1550 


PS ♦ CHUTCH INS> 

LOG I N ♦ CMD ♦ 5 ( AS ) LOG I N ♦ CMD ♦ 5 C OK LI 

M A I L ♦TXT* 1 (A S ) M A X L ♦ T X T ♦ 1 II 0 K 1 

M ISC J CHLJT CHIN S> 

ADEXMP * TST * 1 < AS ) ADEXMP ♦ TST ♦ 1 IL OK LI 
D M P M S G ♦ R NO ♦ 1 (AS) D M P M S G ♦ R N 0 ♦ .1. IL 0 K LI 
DUMP' ♦ XMP ♦ 2 (AS) DUMP ♦ XMP ♦ 2 ILOKLI 

D U M P 1 ♦ T S T ♦ 1 (AS) D IJ M P 1 ♦ T S T ♦ 1 IL 0 K LI 

D U M P 2 ♦ T S T ♦ I (AS) D U M P 2 * T S T ♦ l L 0 K LI 

DUMP3 ♦ TST ♦ 1 ( AS ) DUMP 3 ♦ TST ♦ 1 IL OK LI 
DUMPER ♦ RNO ♦ 1 ( AS ) DUMPER ♦ RNC) ♦ 1 C OK LI 
E X A M P 1 ♦ T S T ♦ 1 ( A S ) EXAM P 1 ♦ T S T ♦ .1. C 0 K 1 
EXAMP2 ♦ TST ♦ 1 ( AS ) EXAMP2 ♦ TST ♦ 1 C.0K3 

F I LE .1. ♦ RNO ♦ 6 ( AS ) FI LE 1 ♦ RNO ♦ 6 l OK 1 

F I L. E 2 ♦ R NO ♦ 1 (AS) F I L E 2 ♦ R N 0 ♦ 1 II 0 K II 

INV ♦ RNO ♦ 2 (AS) INV * RNO ♦ 2 C0K3 

P H 0 TO ♦ EXE ♦ 1 (A S ) P H 0 T 0 ♦ E X E ♦ 1 C 0 K II 


T a t a 1 f :i. 1 e s d u m p e d « 1 5 
Total paries dumped 125 
DUMP EL’ R> 


To deactivate printing before the next transfer operation, type 
NO FILES in response to the DUMPER prompt. 


LIST (LOG INFORMATION ON FILE) file spec 

Normally, DUMPER does not produce a file containing a list of all 
files as it saves them on tape. If you wish to have such a list 
but know it is too long to be printed at your terminal, use the 
LIST command, including the name of the file in which you want 
the list printed. For example, 

DUMP ER>LIST (LOG INFORMATION ON FILE) SPECS ♦ LSTCED 

When the save operation is complete, you can return to TOPS-20 
command level and print the file SPECS. LST or type it on your 
terminal. You cannot use LIST when doing a restore. 
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Example: 


©DUMPERQil) 

DUMPER>TAF'E (DEVICE) TAPE1 »C«D 
dumper>reuindC«D 

DUMPER>LIST < LOG INFORMATION ON FILE) SPECS . LSTCED 
DUMPER>SAVE (DISK FILES) *>RNO C^T) 

DUMPER tape # 1 Volid TAF'El » > Thursday y 5--Jul»79 1556 
M I SC * <HUTCH I NS> 


Total files dumped « 5 
Total p a <2 e s dum ped « 43 

dumper>exitC«D 

@ T Y F : ‘ E < F I L E ) S P E C S ♦ L S T ♦ 2Qll) 

D IJ M P E R t a p e # 1 Voli d T A P El , ? T h u r s d a a , 5 - J u 1 - 7 9 1 5 5 6 


D i r e c t o r w < n u m b e r ) 

f i 1 e 1 a s t write s ize ( p a «f e s ) c h e c k s u ivi 

MISC:<HUTCHINS> (460) 


DMPMSG ♦ RNG ♦ 1 
DUMPER ♦ ENO ♦ 1 
FI LEI ♦ RN0i6 
FIL..E2 ♦ RNO ♦ 1 
I NO * RNG ♦ 2 


22- Jun-79 0852 5 

29-Jun~79 1559 35 

3- Jul-79 1034 1 

3- Ju 1-79 1034 1 

2-Jul-79 1440 1 


Total 5 files ? 43 


Total files dumped « 5 
Total pastes dumped ~ 43 

e 


If you omit a file spec with the LIST command, DUMPER 
automatically creates a file called LPT : DUMPER . LOG , which is 
printed on the line printer. If an existing file is specified, 
the new list of file specs is appended to the existing file. 

To deactivate the LIST command before the next transfer 
operation, type the command NO LIST. 


SILENCE 

As described previously, directory names are normally printed; 
file specs are not. The SILENCE command suppresses the printing 
of directories and file specs as the files are saved or restored. 
The SILENCE command is therefore equivalent to NO DIRECTORIES if 
the FILES command has not been specified. Typing NO SILENCE is 
equivalent to FILES and DIRECTORIES. 

The commands ACCOUNT and PROTECTION define the file characteristics 
for the file being restored from magnetic tape. 
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ACCOUNT (OF RESTORED FILES FROM) keyword 

The ACCOUNT command specifies that any file being restored to 
disk assumes either your current account (specified as 
SYSTEM-DEFAULT) or the account of the file when it is saved on 
tape (specified as TAPE). Without the command, DUMPER uses TAPE. 

If you specify the account incorrectly, DUMPER responds with an 
error message, as follows: 

?Does not match switch or k e s word 


PROTECTION (OF RESTORED FILES FROM) keyword 

The PROTECTION command specifies that any file being restored 
takes either the system default protection code or the protection 
code of the file on tape. The arguments are SYSTEM-DEFAULT 
(usually 777700) or TAPE. Without the command, DUMPER uses TAPE. 

If you specify an invalid keyword, DUMPER responds with the same 
error message as for ACCOUNT. 

Of the commands that set tape characteristics, the TAPE command is 
used most often. The others, described below, either change the basic 
attributes of the tape, prepare it for reading or writing with another 
format, or supply an identifying name for a saveset. 


TAPE (DEVICE) name: 

The TAPE command identifies the mounted magnetic tape to DUMPER. 
The name can be either the physical device assigned to you (such 
as MTA3: or MTO : ) or logical name (such as TAPEl : ) . If you omit 
the command, DUMPER prints the reminder: 

T a p e s p 0 c i f i c a t i o n n e 0 d e d y 
$ T ape f :i. lespec 

and waits for you to supply the device name. If you omit the 
device name, DUMPER responds with an error message, as follows: 

? I n v a 1 i d iti a $ t a p e d e s .i. si n a t o r ? f i 1 0 n a m e w a s n o t s p 0 c i f i 0 d 

If you type the device name incorrectly, DUMPER responds with the 
message : 

? I n v a 1 i d m a si 1 a p 0 d 0 s i si n a t o r y n a s u c h d e v :i. e e 

If you specify a device that is already in use by someone else, 
DUMPER prints: 

? I n v a 1 i d m a si t a p 0 d e a i si n a 1 0 r ? dev :i. c e a 1 r e a d a a a a i si n 0 d t o 
another Job 

As mentioned in Section 7.3, if you define your tape with the 
logical name MTA-DUMPER : , you need not type the TAPE command for 
DUMPER to access the tape. 
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DENSITY (OF MAGTAPE) n 

The DENSITY command sets the density of the tape to the specified 
number of bits per inch (bits/in). The density can be 200, 556, 
800, 1600, 6250 or JOB-DEFAULT (set by the TOPS-20 command SET 
TAPE DENSITY). If you do not specify the DENSITY command, DUMPER 
uses the density listed when you type the TOPS-20 command 
INFORMATION (ABOUT) TAPE-PARAMETERS. If the tape is labeled, the 
density is predetermined by the label information on the tape. 

If you give an invalid density, DUMPER responds with an error 
message as follows: 

? Doe s not match switch or keyword 


PARITY (OF MAGTAPE) type 

The PARITY command sets the parity of the mounted magnetic tape 
to EVEN or ODD. DUMPER normally uses the parity listed when you 
type the TOPS-20 command INFORMATION (ABOUT) TAPE-PARAMETERS (the 
system default is ODD) . If you type anything other than EVEN or 
ODD, DUMPER responds with the same error message as for DENSITY. 


SET BLOCKING-FACTOR (TO) n (RECORDS) 

The SET BLOCKING-FACTOR command sets the number of logical 
records per physical record that DUMPER writes on tape. The 
default value is 1. The number must be in the range of 1 to 15. 
The maximum depends on the density of the tape as follows: 

Density Maximum Blocking Factor 


200 1 

556 3 

800 4 

1600 8 

6250 15 


NOTE 

INTERCHANGE mode must use a blocking 
factor of 1. If the blocking factor is 
changed and you specify INTERCHANGE 
mode, DUMPER resets the blocking factor 
to 1 . 
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Version 4 of DUMPER is capable of blocking records when it writes 
a tape. Blocking is defined as writing physical records that 
contain more than one logical record. (Versions of DUMPER 
previous to Release 4 write only one logical record per physical 
record.) The term "blocking factor" refers to the number of 
logical records per physical record. The advantage of blocking 
is to permit DUMPER to fit more information on a tape than it 
could without blocking, because you are diminishing the number of 
gaps between records. This reduces the number of tapes and the 
amount of time it takes to save and restore files. However, a 
tape written with a blocking factor other than 1, and any labeled 
tape, cannot be restored by DUMPER previous to Version 4 of 
TOPS-20. It is not necessary to give this command when restoring 
files from tape; DUMPER automatically determines the blocking 
factor by reading the tape, and then processes the tape 
accordingly . 

If you specify anything other than a decimal number with the SET 
BLOCKING-FACTOR command, DUMPER responds with an error message as 
follows: 

? F :i. r s t n o i "i s p a e e e h a r a c t e r is not a d i .d i t 
There can be only one blocking factor for each tape. 


FORMAT (VERSION NUMBER IS) n 

The FORMAT command allows DUMPER to write tapes that can be read 
by earlier versions of DUMPER. The number specified must be 
decimal; the default is 4. If you do not use a decimal number, 
DUMPER responds with an error message, as follows: 

?NOT A DECIMAL NUMBER 


INDUSTRY (COMPATIBLE 36-BIT MODE) 

The INDUSTRY command allows DUMPER to read and write tapes using 
the INDUSTRY-COMPATIBLE tape data format of 36 bits. Normally, 
DUMPER uses CORE-DUMP format. 

To return to CORE-DUMP format, type NO INDUSTRY in response to 
the DUMPER prompt. 


INTERCHANGE (FORMAT) 

The INTERCHANGE command allows DUMPER to read and write tapes 
written or to be read by the TOPS-IO BACKUP program. (Normally 
DUMPER uses its own format.) You should never use INTERCHANGE 
when writing tapes to be read by another TOPS-20 system. To 
deactivate the command, type NO INTERCHANGE. The example below 
shows a tape written by the TOPS-IO BACKUP program followed by an 
example of reading a tape using the TOPS-20 DUMPER program in 
INTERCHANGE mode. 
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.mount mtb:backup/write:yes/reelid:macsC*ED 

T Mount Re (sues t BACKUP' Queued > Reauest-ID 109T 
C Volume MACS Mounted on MTB263 as Logical Name BACKUP 1 
BACKUP mounted » MTB263 used 

«R BACKUPGiD 

/TAPE BACKUP 
/FILES 

/INTERCHANGE 

/REWIND 

/SAVE *.MACC30r 51533 


! 30? 5153 

DSKC 

DECPNT 

MAC 

LOCAL 

MAC 

READ 

MAC 

TRMTYP 

MAC 

NDBDEF 

MAC 

NETDPY 

MAC 

PRVCK 

MAC 

DET 

MAC 

" Done 


/EXIT 



.DISMOUNT BACKUP 
M T B 2 6 3 D :i. s iyi o u n t e d 


(3 

©MOUNT TAPE (NAME) MACS: /READ-ONLY /LABEL-TYPE JUNLABELEDCmD 

I" Mount Re ouest MACS Queued? E'e Guest- ID 3.273 

i::i ape set MACS? volume MACS mounted 3 

\: M A C S t def :i. n e d a s M T 2 t 3 

ePUMPERpiD 

D tJ M P E R > T A P E ( D E VICE) MAC S :CHD 
HUM P E R > I N T E R C H A N G E (FORMAT >C«D 

dumper>rewindC“D 

D U M P E R > F I L E SQU) 

DUMPER>RESTORE (TAPE FILES) * . * . * (TO) DSK* :<*>*,*, *C“lD 


DUMPER tape # 1 Vo lid MACSr » Tuesday » 18 -Sep-79 1131 
Loading file(s) into M.ISC J <HUTCHINS> 

DECENT. MAC. (TO) DECF'NT .MAC. 1 C0K3 
LOCAL. MAC. (TO) LOCAL. MAC. 1 P0K3 

READ. MAC. (TO) READ. MAC. 1 C0K3 

TRMTYP . MAC ♦ ( TO) TRMTYP • MAC . 1 II OK 3 
NDBDEF . MAC . (TO) NDBDEF . MAC . 1 C OKI 
NETDPY .MAC. (TO) NETDPY . MAC . 1 COK3 
PRVCK . MAC . (TO) PRVCK.MAC.l t OK 3 

DET.MAC. (TO) DET . MAC . 1 C0K3 

End of save set 

dumper>exitC“D 

© 
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SSNAME name 

The SSNAME command specifies the name to be written in the 
saveset header on the tape or to appear when you type a RESTORE , 
SAVE, SKIP, EOT, or PRINT command. The name may contain up to 30 
alphanumeric characters, including spaces. Whenever you save or 
restore files, the saveset name prints on your terminal. 


NOTE 

Unlike other commands requiring an 
argument, if the name is omitted, DUMPER 
ignores the command and uses the 
existing name if one is present; 
otherwise, it leaves the field blank. 
There is no error message. 


The CHECKSUM command is used in conjunction with the DUMPER SAVE, and 
PRINT commands. (Refer to Section 7.5.2.) 


CHECKSUM (FILES) type 

While files are being saved, a checksum is computed. When you 
type PRINT, each filename is listed with a six-digit octal 
checksum number. 

One of two types can be specified: SEQUENTIAL or BY-PAGES. If 
you specify SEQUENTIAL, DUMPER computes a checksum for the entire 
file. (In INTERCHANGE mode, you should use only sequential 
checksums.) If you specify BY-PAGES, the checksum includes each 
word of existing pages up to the End-Of-File (EOF) pointer. When 
you type PRINT after requesting a checksum by pages, the checksum 
number is followed by the letter P, as shown in the example 
below. 

@dumperC“D 

DUMPER>TAPE (DEVICE) TAPEl 

dumper>rewindQll) 

DUMPER>C HECK SUM (FILES) BY-PAGESQiD 
DUMPER>PRINT (DIRECTORY OF TAPE ONTO FILE )<j«D 


DUMPER tape # 1 Volid TAPEl y y Thursday? 5-Jul-79 1555 


file 

last write 

size 

( passes ) 

checksum 

M I SC : < HUTCHINS > P H 0 T 0 ♦ EXE * 1 

5-Jul~79 0830 

6 


442725 P 

DUMPER tape # 1 Volid TAPEl y y 
file 

Thursday? 5-Jul- 
last write 

-79 1556 
size 

( passes ) 

checksum 


MISC* <HUTCHINS>DMPMSG * RNO ♦ 1 

22-Jun-79 0852 

5 

202247 P 

M I SC : <HUTCHINS>DUMPER ♦ RNO ♦ 1 

29- Jun-79 1559 

35 

677675 P 

MISC ♦ <HUTCHINS>FILE1 ♦ RNO ♦ 6 

3- Jul-79 1034 

1 

756473 P 

MISC ♦ <HUTCHINS>FILE2 ♦ RNO ♦ 1 

3- Jul-79 1034 

1 

756473 P 

MI SC : CHUT CH I N S> I N V ♦ RNO • 2 

2- Jul-79 1440 

1 

565436 P 


End of tape* 
"L 
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When the checksum of the disk file disagrees with the checksum of 
the tape file, there is an error in the file transfer. 

If you specify an invalid argument, DUMPER responds with an error 
message, as follows: 

TDoes not match switch or keyword 


Two other Status-Setting commands allow you to recover after a system 
crash without restarting at the beginning of your save or restore 
operation, or to continue a save onto a second reel of tape. 

INITIAL (FILESPEC) file spec 

The INITIAL command allows you to continue on a new tape the 
operation of checking, restoring, or saving at the specified 
file. This command is useful in conjunction with the SET 
TAPE-NUMBER command if the system crashes while you are 
performing a check, save, or restore. For example, if DUMPER is 
in the process of saving FILE3 when the system crashes, mount a 
new tape, run DUMPER, and type 

D U M P E R > I N I T I A L < F I L E S P E C ) FI L E 3 G"D 

In case FILE 3 is distorted on the first tape, it is saved again 
in its entirety on the second tape. 


NOTE 

If you do not specify a filename, the 
operation begins with the first file 
specified in the SAVE command. 


SET TAPE-NUMBER (DECIMAL NUMBER) n 

The SET TAPE-NUMBER command is used for multi-reel savesets in 
either of two cases: when continuing a save or restore after a 
system crash, or when restoring files nonsequentially from a 
multi- reel save set . 
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Example: 

To continue a save following a crash: 

SDUMPERCeeD 

DUMPER>T APE ( DEVI CE ) TAPE 2 :G"D 

dumper>reuindQE) 

D U M P E R > I N I T I A L < F I L E S P E C ) < H U T C: H INS > F I L E 3 ♦ T S T G“D 
DUMPER>SET TAPE-NUMBER (DECIMAL NUMBER) 2 C^T) 

D U M P E R > S A V E ( D I S K F 1 1... E S ) *♦ T S T(« D 


If you omit the tape number, DUMPER responds with an error message as 
follows : 

? F i r s t n o n s p a c e c h a r a c t e r i s n o t a d i $ i t 

If you include a character other than a digit, DUMPER responds with 
either: 

? F i r s f n o ri s p a c e c h a r a e t e r i s n o t d i 3 i t 

or 

?NOT CONFIRMED 


7.5.2 Positioning the Tape 

Tape-Positioning commands control the position of the tape without 
transferring information between the tape and disk. These commands 
affect the tape you specified with your last TAPE command to DUMPER. 
If you did not use a TAPE command, DUMPER issues a request for one, or 
uses a tape assigned to the logical name MTA-DUMPER: . If you are 
working on a system without tape drive allocation, before entering 
DUMPER, you must assign the tape drive to your job, using the TOPS-20 
command ASSIGN. 

Table 7-2 lists the four Tape-Positioning commands and their 
functions. Following the table is a detailed description, including 
examples, of each command. 


Table 7-2 

Tape-Posi tioning Commands 


Function 

Commands 

Positioning to the end 
of the last saveset 

EOT 

Positioning to the beginning 
of the currently mounted tape 

REWIND 

Positioning to the end of the nth 
from the current saveset 

SKIP n 

Rewinding the tape entirely onto 
the source reel 

UNLOAD 
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The three commands below position the tape at specific points. 

EOT 


The EOT (End-Of-Tape) command positions the tape at the end of 
the last saveset and DUMPER prints the message: 

Tape positioned after last saveset 

As DUMPER encounters each saveset between its current position 
and EOT , it prints the saveset name (but not its contents) and 
the time and date the saveset was written. 

Example : 


G DUMFERfiip 

D U M P E R > T A P E ( D E V I C E ) T A P E 1 :GfD 
DUMPER> REWINDCeD 
DUMPER> EOTCED 


DUMPER 

tape 

# 

1 

Vo lid 

TAPE1 v 

? Tuesday v 

5-Jun-79 

1142 

DUMPER 

tape 

# 

1 

Vo lid 

TAPE 1 9 

9 Tuesday 9 

5-Jun-79 

1 159 

DUMPER 

tape 

# 

1 

Vo 1 id 

TAPE It 

9 Tuesday y 

5- Jun-79 

1327 


Tape positioned after last saveset 
DUMPER> 


REWIND 

The REWIND command rewinds the currently mounted volume to the 
beginning of the tape. 

If you are using a multi-reel tape set mounted by typing the 
TOPS-20 command MOUNT TAPE , you can switch to a different reel by 
typing: 

REWIND SWITCHING (TO VOLUME NUMBER) r.QiD 

With this command, n specifies the number of the reel within the 
set; not the volume id. When you type the REWIND SWITCHING 
command, DUMPER releases the currently mounted tape and requests 
the nth volume to be mounted. (If you are using labeled tapes, 
DUMPER allows you to switch to volume 1 only.) The following 
example shows a switch to the volume identified as TWO from 
volume ONE: 


G MOUNT TAPE TAPE 15 /WRITE-ENABLED /VOL I DS : ONE > TWO > THREE C™D 
II M o u n t R e « u e s t T A P E 1 G u e u e d ? R e « u e s t - 1 D 1 7 4 II 
FI T a p e s e t T A P E 1 v v o 1 u m e 0 N in o u n t e d II 
II TAP E 1 * def i n e d a s M T 0 ♦ II 
G DUMPERfSP 

D U M P E R > T A P E ( D E V I C E ) T A P E 1 :QED 

DUMPER> REWIND SWITCHING (TO VOLUME NUMBER) 2QfD 
BUM PER > 
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NOTE 

If you plan to switch back and forth 
between volumes of a set, specify the 
/NOUNLOAD switch with the TOPS-20 
command MOUNT TAPE. This is a request 
to the operator not to unload any of the 
tapes within the set, but to use 
additional tape drives so that more than 
one tape can be mounted at a time. 


SKIP (NUMBER OF SAVESETS) n 

The SKIP command moves the tape over the specified number of 
savesets. This ensures that those savesets are not deleted by 
another save. DUMPER prints the name of each saveset 
encountered, and positions the tape at the end of the nth 
saveset. 

If n is 0, the tape is positioned at the beginning of the current 
saveset. If n is a negative number, the tape backspaces by n 
savesets and is positioned at the beginning of that saveset. If 
n exceeds the total number of savesets on tape, DUMPER performs 
an EOT and prints the message: 

%Erid of tape encountered 

If -n exceeds the total number of savesets on tape, DUMPER 
reaches the beginning of the tape and prints the message: 

% B E G I N N I N G 0 F T A P E E N C 0 U N T E E E D 


Examples : 


BDUMPERTiiD 

DUMPER>TAPE (DEVICE) TAPEljQiD 

dumper>reuindc«D 

DUMPER>SKIP (NUMBER OF SAVESETS) lCED 

DUMPER tape t :L Vo lid TAPE Ik k Tuesday k 5-Jun-79 1142 

DUMPER tape # 1 Volid TAPE Ik k Tuesday k 5-Jun-79 1159 
DUMPER> 


DUMPER>SKIP (NUMBER OF SAVESETS) -lGED 

DUMPER tape # 1 Volid TAPEIk k Tuesday k 5-Jun-79 1142 
/(BEGINNING OF TAPE ENCOUNTERED 
DUMPER > 
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The following command releases your mounted tape from the drive. 

UNLOAD 

If your installation is not using tape drive allocation, you can 
remove your tape with UNLOAD to DUMPER. 

Example : 

DUMPER>UNLQAPr^D 

This command, however, does not deassign the tape drive. 


7.5.3 Interacting with Tape Files 

The Action commands affect the files on the tape specified by the last 
TAPE command. These commands allow you to start, stop, interrupt, or 
continue a file transfer or file check. 

The transfer commands take, as an optional argument, one or more file 
specs. The file specs can contain wildcard characters. With transfer 
commands (SAVE and RESTORE) , you can indicate both input and output 
(source and destination) file specs for each file specified. This 
allows the files to be renamed as they are saved or restored. If no 
destination specification is given, the specified files are 
transferred without being renamed. If no argument is given with the 
transfer commands, all files on your connected directory are saved 
onto tape, or all files that were saved from your connected directory, 
and exist in the current saveset, are restored to your connected 
directory. 

Both the SAVE and RESTORE commands can take the source and destination 
arguments. In the case of SAVE, the source is the file spec 
identifying the name and location of the file to be saved; the 
destination identifies the filename under which you want the file to 
be stored on tape. In the case of RESTORE, the source is a file spec 
identifying the file you want copied from the tape; the destination 
is a file spec identifying the name of the file into which you want 
the file copied on disk. 

With both commands, if you omit the source, DUMPER restores all files 
in the saveset corresponding to your connected directory, or saves all 
files as your connected directory. If you omit the destination with 
SAVE, DUMPER transfers the file(s) with the same file spec(s) as the 
one(s) on disk. If you omit the destination with RESTORE, DUMPER 
transfers the file(s) with the same file spec(s) as the one(s) on 
tape . 

Table 7-3 lists all Action commands according to their functions. A 
detailed description of each command follows the table. 
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Table 7-3 
Action Commands 


Function 

Commands 

Transferring and 

comparing disk and tape files 

RESTORE, SAVE 

CHECK 

Printing a list of 
filenames on tape 

PRINT 

Halting and continuing 
command operation 

CTRL/E, CONTINUE 

Exiting to TOPS-20 

EXIT, QUIT 


SAVE (DISK FILES) source (AS) destination, source (AS) destination 

The SAVE command creates a saveset on tape, containing all the 
source files specified. To rename the files as you save them, 
you must specify source files followed by a space, followed by 
destination files. With either source or destination files you 
can use * and % wildcard characters. To transfer additional 
source and destination file specs, you must separate each pair 
with a comma. 

If you do not specify destination, DUMPER saves all source file 
specs under their original specifications. If you specify 
neither source nor destination, DUMPER saves all files on your 
connected directory into the saveset on tape (i.e., DUMPER 
assumes the file spec *.*.*). 

Examples : 

Note that in these examples, three savesets are created; one for each 
SAVE command. 


©dumperGID 

DUMPER>TAPE ( DEVICE ) TAPEi:(«D 
D LJ M P E R > R E W I N DQED 

DUMPER>F I LESCOT) 

DUMPER>SAVE (DISK FILES) DMPMSG ♦ RNO ♦ * (AS) DMPMSG ♦ BAKQeD 

D U M P E R t a p e # 1 V o 1 i d T A P Ely y F r i d a w y 6 - J u 1 - 7 9 1 1 4 5 
MISC:<HUTCHINS> 

DMPMSG ♦ RNO ♦ 1 ( AS ) DMPMSG ♦ DAK ♦ 1 I OK II 


T o t a 1 f i 1 e s d u m p e d ~ 1 
Total Fades dumped ® 5 
DUMPER >SAVE (DISK FILES KRNOQID 
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DUMPER tape # 1 Volid TAP El » v Friday » 6~Jul-79 1147 

MISC i <HUTCHINS> 

D M P M 8 G . R N 0 . 1 (AG) D M P M S G . R N 0 ♦ 1 C 0 K II 
FILE1 4 RNO * 6 (AG) FILE1.RN0.6 C0K3 
FILE2.RN0. 1 (AG) FILE2.RN0. 1 1:010 

INU * RNO « 2 (AG) INV.RNQ.2 IIOIO 


Total files dumped = 4 
Total pastes dumped ~ 8 
DIJMPER> 


D IJ M P E R > SAVE ( D I S K F I L E S ) C HD 

D IJ M P E R t a p e # .1. V o 1 :i. d T A P E If y W e d n e s d a y y 6 •••• J u 1 -• 7 9 1 2 1 7 


MISC! < H U T C H I N S > 

A D E X M P ♦ T S T ♦ 1 (A S > A D E X M P ♦ T S T ♦ J. C 0 K :i 
B A C K E R ♦ D 0 R ♦ 1 (AS) BA C K E R ♦ D 0 R ♦ 1 E 0 K II 
D M P MSG ♦ R NO ♦ 1 (A S ) D M P M S G ♦ R N 0 ♦ 1 E 0 K 3 
D LJ M P ♦ X M P ♦ 1 (A S ) D U M P ♦ X M P ♦ 1 C 0 K 1 

D U M P 1 ♦ T S T ♦ 1 (A S ) D U M P 1 ♦ T S T , 1 L 0 K II 

D U M P 2 ♦ TST ♦ 1 ( A S ) D U M P 2 * T S T , 1 C 0 K :\ 

D U M P E R ♦ T S T ♦ 1 (A S ) BUM P E R ♦ T S T ♦ 1 E 0 K 3 
EX AMP 1 ♦ BMP ♦ 1 ( AS ) EX AMP 1 ♦ BMP ♦ 1 C OK 3 
F I L E 1 ♦ RNO *6 (A S ) F I L E 1 ♦ R N 0 ♦ 6 IT. 0 K II 

F I L E 2 ♦ RN 0 ♦ 1 (A S ) F I L E 2 ♦ R N 0 ♦ 1 C 0 K :i 

INV ♦ RNO ♦ 2 (AS) INV ♦ RNO ♦ 2 LOK 3 

I N V ♦ 1ST ♦ 1 ( AS ) I N V ♦ 1ST ♦ 1 E OK 3 

PHOTO ♦ EXE ♦ 1 ( AS ) PHOTO ♦ EXE ♦ 1 C OK 3 

SPECS ♦ L..ST ♦ 1 ( AS ) SPECS ♦ L ST ♦ 1 E OK :i 


T o t a 1 f :i. II. e s d u iti p e d « 1 A 
Total pa sles dumped = :: 59 
DUMPER> 


NOTE 

Remember that if the FILES command is 
not typed, the file specifications are 
not listed as they are saved. 


If all files cannot fit on one tape, DUMPER requests that you mount a 
second tape. This tape is the next volume of the tape set if you type 
/VOLIDS: with the MOUNT TAPE command. If you do not specify the 
switch, the operator mounts a tape and it becomes the second volume of 
the set. When the additional tape is mounted, DUMPER prints a header 
line and resumes the save operation. (Refer to Example 9 in Section 
7.5.5.) 


It is important to note that savesets are stored on tape according to 
the position of the tape when the SAVE command is typed. If you 
position the tape at the beginning (refer to the REWIND command), the 
specified files are written there regardless of any previous files 
saved. If more than one saveset exists on the tape, they are all 
deleted when a new one is saved at the beginning of the tape. To 
avoid deleting existing savesets, position the tape at the end of the 
last saveset (EOT) or skip the number of savesets (SKIP n) you want to 
be sure to preserve. 
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Furthermore, if you exit from DUMPER (EXIT, or QUIT) after a save 
without rewinding the tape, DUMPER remains positioned at the end of 
that saveset. When you reenter DUMPER and type another SAVE command, 
the first saveset is preserved. However, DUMPER does not remember the 
previous record numbers or blocking factor. 


NOTE 

DUMPER assigns record numbers for its 
own use. Each time DUMPER writes a new 
record, it increments the record by one. 
With the numbering system, DUMPER can 
determine which records are duplicates 
and which have been skipped during a 
read operation. (There is one record 
number for each logical record. 
Therefore, if you have a blocking factor 
of 3, the first physical record contains 
records 1, 2, and 3. Refer to the SET 
BLOCKING-FACTOR command.) 


Therefore, if you reenter DUMPER after one save, DUMPER saves new 
files as record 1, record 2, etc. with a blocking factor of 1. If 
you originally specified a blocking factor other than 1, and if you 
wish your files to be numbered consecutively, beginning with the first 
saveset, you must type REWIND, followed by EOT when you reenter 
DUMPER. By returning to the beginning of the tape, DUMPER determines 
both the blocking factor and the record numbers already saved. By 
then being positioned at the end of the last saveset, DUMPER preserves 
all existing savesets. It then continues saving files with 
consecutive record numbers and a blocking factor corresponding to that 
of the existing savesets. 


RESTORE (TAPE FILES) source (TO) destination, source (TO) destination 

The RESTORE command transfers the specified source files from 
magnetic tape to disk. To rename the files as you restore them, 
you must specify destination file specs. With source files, you 
may use the * and % wildcard characters; with destination files, 
you can use only the * wildcard. 

If you do not specify destination, all specified files are 
restored with the same name, type, and generation. If you do not 
specify either source or destination specifications, all files 
saved from your connected structure and connected directory are 
restored to your connected structure and directory with the same 
name, type and generation number. 


NOTE 

You cannot restore files from a labeled tape under 
versions of TOPS-20 previous to Version 4. 

When DUMPER begins restoring files to a directory, it prints the 
message : 


I... o a d i n d F i 1 e < s ) i ri t o < d i r e c t o r y > 
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If you do not see this message, DUMPER is not transferring the 
files. The files may already exist on disk, they may have been 
saved from a structure or directory other than your currently 
connected directory, they do not exist in the current saveset, or 
you used a wildcard expression that does not match the files on 
tape . 

If you are restoring files that were saved from a directory other 
than your own, you must specify that directory in the source file 
spec. If files exist on that directory with the same name and 
type as those on tape, DUMPER overwrites the disk files according 
to the condition specified with the SUPERSEDE command: ALWAYS, 
NEVER, or OLDER. If the SUPERSEDE command has not been typed, 
DUMPER assumes SUPERSEDE OLDER and overwrites the disk file only 
if the tape file is newer. 


As is true of the SAVE 
current position on 
savesets, position the 
omitted (SKIP n) . 


command, files are restored from the 
tape. If you want to omit one or more 
tape to the end of the last saveset to be 


Example : 


©DUMPER GiD 

DUMPER>TAPE ( DEVICE ) T APE 1 :QED 
DUMPER> REWIND® 

DUMPER>SKIP (NUMBER OF SAVESETS) 2 (^0 

DUMPER tape # 1 Vo lid TAPEly v Tuesday y 5-Jun-79 155 6 

DUMPER tape # 1 Volid TAPEl* y Wednesday v 27-Jun~79 1432 

D li M P E R t a p e # 1 V o 1 i d T A P E 1 * y T u e s d a y v 3 - J u 1 ~ 7 9 1 1 5 0 

DUMPER>FILES fiiT) 

DUMPER> RESTORE ( TAPE F I LES ) * ♦ TST C^P 


DUMPER tape # 1 Volid TAPEl* * Tuesday * 3-Jul-79 1150 

Loading file(s) into MISC t <HUTCHINS> 

MI SC t <HUTCHINS>DUMP1 ♦ TST ♦ 2 * P777700 y A341 ( TO ) DLJMP1 * TST ♦ 2 C OK J 

MISC t < HUTCHINS > D U M P 2 ♦ TST ♦ 2 f P777700 y A341 ( TO ) DUMP 2 ♦ TST ♦ 2 COKI 

MISC ♦ <HUTCHINS>DUMP3 ♦ TST ♦ 2 5 P777700 * A341 (TO) DUMPS* TST *2 C0K3 

End of saveset 
DUMPER> 


Once the files have been saved or restored, you can check the disk and 
tape versions to verify that the transfer was accurate. 


CHECK (ALL TAPE FILES) 

The CHECK command checks the files in the current saveset to make 
sure they agree (i.e., their contents and File Descriptor Blocks 
match) with the files on disk. If any files do not agree, DUMPER 
prints one or more error messages. Table 7-4 is a list of the 
possible differences in the FDBs that DUMPER checks. 


NOTE 

Be sure to position the tape at the beginning of the 
saveset before typing CHECK. 


7-27 


THE DUMPER PROGRAM 


Table 7-4 

File Descriptor Block ( FDB) Entries Checked by DUMPER 


A difference 
in location 

Means the files do not have the same: 

. FBCTL 

-Temporary, permanent , not- to-be- saved- by 

DUMPER, or file-class status. 

. FBPRT 

-File access code. 

. FBCRE 

-Date and time of last write to the file. It 

is modified when any program writes to the 
file. This word is changeable by a user with 
privileged capabilities. 

. FBAUT 

-Pointer to the string containing the name of 
the author. 

. FBGEN 

-Generation and directory numbers of the file. 

. FBACT 

-Account information. 

. FBBYV 

-Number of generations to retain, byte size, 
mode of the last write, or the number of 
pages . 

. FBSIZ 

-Number of bytes in the file. This word is 

changeable by a user with write access. 

. FBCRV 

-Date and time of creation of the file. This 

word is changeable by a user with write 
access. 

. FBWRT 

-Date and time of the last user write to the 
file. This word is changeable by a user with 
write access. 

. FBREF 

-Date and time of the last non-write access to 
the file. This word is changeable by a user 
with write access. 

. FBCNT 

-Count of writes or references. 

. FBUSW 

-Contents of the user-settable data area. 

. FBLWR 

-Pointer to the string containing the name of 
the user who last wrote to the file. 


Example: 


dumper>rewindC«£D 

DUMPER> CHECK (ALL TAPE FILES >QE) 


DUMPER tape * 1 Volid ARCH 1 » 
%Co nfipa re errors pade 17 y file 
% D i f f e y v e n c e i n ♦ F B C R E o f t :i. 1 e 
% Difference in ♦ FBCRV of file 
’/.Difference in ♦ FBWRT of file 


F r i d a y y 8 - J u n - 7 9 1 0 A 1 
DUMPER ♦ END ♦ 3 
DUMPER ♦ ENG ♦ 3 
DUMPER ♦ ENG ♦ 3 
DLJMPEE ♦ ENG ♦ 3 


End of saveset 
DUMPEE> 


If a file is renamed during a save or restore, using CHECK 
produces the message: 


% C a n n o t e t J F r N f o r f i 1 e C f i 1 e II b e c a u s e t 
File not found 
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If a disk file is modified or renamed before you do a check, the 
tape and disk file will not agree in either name, type, or 
generation. In this case, DUMPER prints the message: 

% Cannot <aet JFN for file Cfilell because: 

File not found 


If you want a printed list of all files saved on tape, position the 
tape to the beginning and type the PRINT command. This command 
differs from LIST in that it creates a file of filenames already on 
tape. LIST creates a file of filenames as DUMPER is saving the files. 


PRINT (DIRECTORY OF TAPE ONTO FILE) file spec 

The PRINT command records the file specs of the entire tape 
(beginning with the current saveset) in the specified output 
file. You can subsequently use the TOPS-20 TYPE or PRINT command 
to examine this file. The filenames are not printed on your 
terminal unless you specify TTY: as the output device. 


@ dumperCOD 

DUMPER> tape (DEVICE) TAPF1 
_ DUMP EE > REUINDCkD 

DUMPER> PRINT (DIRECTORY OF TAPE 


ONTO FILE) 


FILES ♦LST ♦ iGUD 


DUMPER tape # 1 Valid TAPE! v v Tuesday? 5-Jun~79 15 56 


DUMPER tape # 1 Vo lid TAPE 1 x > Tuesday n iO-Jul-79 1457 


DUMPER tape # 1 Vo lid TAPE 1 v v Wednesday y ll-Jul-79 1329 
End of tape* 

DUMPER>EXITC ED 

® T Y P E ( F I L E ) F I L E S * L S T f^D 


If you omit the destination file spec, the contents of the 
current saveset are printed on your terminal. 


If necessary, you may interrupt the operation of an action or 
Tape-Positioning command. You may then continue the operation, or 
cancel it by typing another command. 


CTRL/E 

You type the CTRL/E command by pressing the CTRL and E keys 
simultaneously. This command halts the action of a SAVE, 
RESTORE, CHECK, RETRIEVE (if you are a privileged user), or any 
Tape-Positioning command. When DUMPER processes the CTRL/E 
command, it interrupts the current operation and prints: 


(ctrl/e) 

Interrupting * * ♦ 
DUMPER> 
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You can type any Status-Setting command in response to the 
prompt, and then type CONTINUE to continue the operation at the 
point at which it was interrupted. If you type any other 
command, DUMPER asks: 

% Do you really want to abort your interrupted command? 

If you respond with YES, DUMPER processes the last command you 
typed. If you respond with NO, DUMPER gives you its prompt, 
allowing you to continue the interrupted command. 


CONTINUE 

The CONTINUE command allows you to continue the operation of an 
interrupted Action or Tape-Positioning command. 

You cannot use the CONTINUE command if you have not interrupted 
DUMPER with CTRL/E, or if you have typed anything other than a 
Status-Setting command and have answered YES to the question: 

%r.io you really want to abort your interrupted command? 

If you try, DUMPER responds with the message: 

?CANNQT CONTINUE 
DUMPER> 


Example: 


bdumperChD 

HUM P E R > T APE ( D E V I C E ) T A P E 1 t fiFT) 

dumper>rewindQ1D 

DUMPER > PR INI (DIRECTORY OF TAPE ONTO F I LE )C*ED 

DUMPER tape * .1. Vo lid TAPE 1 y ? Thursday* 5-Jul-79 1550 

f i 1 e? I a s t w r :i. t e s i z e ( p a <3 e s ) c h e c k s u m 


P S : < HUTCHINS > L. 0 G I N ♦ C M D ♦ 5 12-Jun-79 1147 1 052026 P 

PS : < H U T C H INS > MAIL ♦ TXT ♦ 1 (TtruD 
1 nterruptinsl ♦ ♦ ♦ 

Ii U M P E R > REUIN DGeT) 

%Do you really want to abort your interrupted command? YQHD 
D U M P E R > C 0 N T 1 N IJ ECEuD 
?CANN0T CONTINUE 
DUMPER> 


There are two commands to exit from the DUMPER program and return to 
TOPS-20 command level. The EXIT and QUIT commands have identical 
functions . 

Example: 

dumper>exit(«D 

G> 
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7.5.4 Marking Files to be Archived 

If you wish to save any of your files on the installation's archive 
tape, you can mark the files for archival. To do this, use the 
TOPS-20 ARCHIVE command. Once the operator has processed your 
request, only the File Descriptor Blocks (FDB's) remain. The 
filenames become invisible (i.e., if you take a directory of your disk 
area, the files appear to be gone) . This is to assure you that your 
files have been archived and that you can no longer access or modify 
them. When the files have been archived successfully, DUMPER sends 
you a message. 


NOTE 

To see your files listed in the archive 
request queue, type the TOPS-20 command 
INFORMATION ARCHIVE-STATUS. 


7.5.5 Additional Examples 


The following examples show various ways to save and restore files, 
and how to recover after a system crash. The examples also 
demonstrate the use of Status-Setting commands before transferring 
files . 


Examples of SAVE: 

1. Mounting a tape and saving your entire directory. 

Give the MOUNT TAPE command specifying /WRITE-ENABLED. Once 
the tape is mounted, run DUMPER, naming the saveset FULL SAVE 
and requesting DUMPER to list all file specifications as it 
saves them. 


@ MOUNT TAPE TAPE1J /LABEL-TYPE l UNLABELED /WRITE - E N A B L E D CEED 
C Mount Reouest TAPE1 Queued y Reeuest-ID 70 3 
C T ape set TAPElv volume TAPE1 mounted 11 


CTAPE 1 ♦ defined as MTOi 3 

©humperGID 

DUMPER > TAPE (DEVICE) TAPE! :CEED 
DUMPER>REWINDQll) 

DUMPER> SSNAME FULL SAVE C«D 


DUMPER > FILE Sf^Q 

FILES >C«D 


DUMFER> SAVE 

(DISK 


DUMPER tape 

# 1 

Vo lid TAPE1 ? 

FULL S 

MISC:<HUTCHINS> 



ADEXMP ♦ TST ♦ 1 

(AS) 

ADEXMP ♦ TST ♦ 

1 11 OK 3 

BACKER ♦ DOR ♦ 1 

(AS) 

BACKER ♦DOR ♦ 

1 C0K3 

DMPMSG ♦ RNO ♦ 1 

(AS) 

DMPMSG ♦ RNO ♦ 

1 L0K3 

DUMP ♦ XMP ♦ 1 (AS) DUMP ♦ XMP ♦ 1 

c:ok3 

DUMP1 ♦ TST ♦ 1 

(AS) 

DIJMP1 ♦TST ♦ 1 

COK 3 

DUMP2 ♦ TST ♦ 1 

(AS) 

DUMP2 ♦ TST ♦ 1 

C0K3 

DUMPS ♦ TST ♦ 1 

(AS) 

DUMPS ♦ TST ♦ 1 

C0K3 

DUMP4 ♦TST ♦ 1 

(AS) 

DUMP4 ♦ TST ♦ 1 

I10K3 

DUMPS ♦ TST ♦ 1 

(AS) 

DUMPS ♦ TST ♦! 

C0K3 


Tuesday? 


3- Jul-79 


1126 
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DUMPER. 1ST. 1 (AS) DUMPER. TST.l COKI 
EXAMP1. TST.l (AS)'EXAMPl. TST.l COK3 
EXAMP2. TST.l (AS) EXAMP2. TST.l COKT 


FILEl.RNO.l (AS) FILEl.RNO.l COKl 
FILE2.RN0.1 (AS) FI L.E2 . RNO . 1 COK1 
INV.RN0.2 (AS) INV.RN0.2 COK3 
INV. TST.l (AS) INV. TST.l COKl 
PHOTO . EXE . 1 (AS) PHOTO . EXE . 1 COKl 


Total files dumped = 17 
Total pases dumped = 54 
DUMPER> 


2. Saving a single file into a second saveset. 

Without rewinding the tape, type the SAVE command for one 
file. 


DUMPER>SAVE (DISK FILES) PHOTO. EXE.# ( AS )f^P) 

DUMF'ER tape # 1 Volid TAF'El. . Wednesday. ll-Jul-79 1329 
MI SC 5 <HUTCHINS> 

PHOTO.EXE. 1 (AS) PHOTO . EXE ♦ 1 COK1 


Total files dumped = 1 
Total pages dumped = 6 
DUMPER> 


3. Saving files from another structure. 

Save all files from a mountable structure (for example, 
MISC : ) 


(?DUMPER'C«D 

DUMPER>TAPE (DEVICE) TAPEUGE) 

DUMPER >R E W I N P GE ) 

DUMPER>SSNAME MISC FILES GTP) 

DUMPER>FILESC«D 

DUMPER>SAVE (DISK FILES) MISCJQID 

DUMPER tape * 1 Volid TAPEl. MISC FILES. Tuesday. 3-Jul-79 1154 
MISC 1 <HUTCHINS> 

FILE1.TXT. 1 (AS) FILE1.TXT.1 COKII 

FILE2.TXT. 1 (AS) FILE2.TXT. 1 COKH 

FILE3.TXT. 1 (AS) FILES . TXT , 1 C0K3 


Total files dumped = 3 
Total pasles dumped = 17 
DUMPER> 
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4. Saving multiple files. 

Save three separate files and rename the third one as it is 
saved . 


©dumper CIlD 

D U M P E R >T A P E < D E VICE) T A P E 1 :GED 
D IJ M P E R >R E W I N D CUD 

D U M P E R > F I L E S CUD , s 

D UMP ER>SAVE (DISK FILES) F I L E 1 ♦ R N 0 1 F I L E 2 ♦ R N Q * PHOTO ♦ EXE ♦ # (AS) EX*ONEC«D 

DUMPER tape # 1 Volid T APE1 y y Monday y 2~Ju.I~79 0829 
MISC ♦ <HUTCHINS> 

FILE1 ♦ RNQ«6 (AS) FILE! ♦ RNO ♦ 6 COKD 
M I S C ♦ < H U T C H I N S > 

FILE2 ♦ RNO ♦ I (AS) F ILE2 ♦ RNG ♦ I COKD 
M ISC ♦ <HUTCH I NS> 

PHOTO ♦ EXE « 1 (AS) EX*0NE*1 COKD 


T o t a 1 f i I e s d u m p e d •“ 3 
Total P3£ies dumped = 8 
DUMPER> 


5. Saving files modified since, or accessed before a specified 
time . 

Save all files created or modified since 31-May-79 

( 00 : 00 : 01 ) . 

Note that when you do not specify a saveset name ( SSNAME ) , 
two consecutive commas are printed. The saveset name 
normally appears between these two commas. 


gdumperGID 

DUMPER> TAPE (DEVICE) TAPE1 
DUMPER>REUINDC« D 
DUMPER>FILESChD 

DUMPER> SINCE (DATE AND TIME) 31-MAY-79Q1D 
DUMPER> SAVE (DISK FILES )QID 

DUMPER tape * 1 Volid TAPE1 y y Friday y 29-Jun-79 :l. 156 


MISC ♦ <HUTCHINS> 

ADEXMP ♦ TST ♦ 1 (AS) ADEXMP ♦ TST ♦ 1 COK3 
BACKER ♦ DOR ♦ .1 (AS) BACKER ♦ DOR ♦ 1 COK'D 
DMPMSG ♦ RNO ♦ 1 (AS) DMPMSG.RN0.1 C0K.1 
DUMP ♦ XMP ♦ 1 (AS) DUMP ♦ XMP ♦ 1 COK'D 

DUMPER ♦ TST ♦! (AS) DUMPER ♦ TST ♦ 1 COKD 
EX AMP 1 ♦ DMP ♦ 1 (AS) EX AMP 1 ♦ DMP ♦ 1 COKD 
EXAMP2 ♦ DMP « 1 (AS) EXAMP2*DMP*1 COKD 
FILES ♦ L.ST ♦ 1 (AS) FILES ♦ L..ST ♦ 1 COKD 
I N V ♦ R N 0 ♦ 2 (AS) INV ♦ RNO ♦ 2 COKD 

SPECS ♦ LST ♦ 1 (AS) SPECS ♦ LST ♦ 1 COKD 


Total files dumped = 10 
Total paSes dumped = 47 
DUMPER> 
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Save files with type .QNO accessed (read in some way but not 
modified) before 15-July-79 at 5:00 p.m. 


PDUMPER f^T) 

DUMPER>TAPE (DEVICE) TAPEllC“D 

dumper>rewindGID 

dumper>filesGED 

DUMPER>ABEFORE (DATE AND TIME) 7/15/79 17: 00 0^0 
DUMPER>SAVE (DISK FILES) **QN0G"D 

DUMPER tape * 1 Volid TAPE1 * y Wednesday* 13- Jun-79 1158 
MI SC *<HUTCHINS> 

FILE! ♦ QNO ♦ 3 (AS) FILE1*QN0*3 COKH 


Total files dumped « 1 
Total pades dumped = 1 
DUMPER> 


6. Specifying and verifying a checksum. 

Instruct DUMPER to calculate, sequentially, the checksum of 
all files in all savesets. When you type PRINT, DUMPER 
prints the file specs, including the checksum. 


@dumperQlD 

DUMPER>TAPE (DEVICE) TAPE1 JQED 
D U M P E R > R E U I N D QlD 

D U M P E R > C H E C K S U M (FI L E S ) S E Q U E N T I A I ...CUD 
DUMPER>PRINT (DIRECTORY OF TAPE ONTO FILE X^T) 

DUMPER tape * 1 Volid TAPE1 t y Thursday* 5-Jul-79 1555 


f lie 

last write 

size 

( pages ) 

checksum 

MISC J < HUTCHINS > P H 0 T 0 . EXE ♦ 1 

5-Jul-79 0830 

6 


442725 

DUMPER tape # 1 Volid T APE 1 * y 
file 

T h »..i r s d a y y 5 - J u 1 - 7 9 
last write 

1 5 5 6 

size 

( pades ) 

checksum 


MISC J <HUTCHINS>DMPMSG ♦ RN0 ♦ 1 

22- Jun-79 0852 

5 

501123 

MISC J < HUTCHINS > DUMPER ♦ RN0 * 1 

29- Jun-79 1559 

35 

737736 

MISC J < HUTCHINS > FILE 1 ♦ RN0 * 6 

3™ Jul-79 1034 

1 

773516 

M I S C : < H U T C H I N S > F I L E 2 ♦ R N 0 ♦ 1 

3- Jul-79 1034 

1 

773516 

M I SC : < HUTCH I NS> I N V * RN0 * 2 

2™ Jul-79 1440 

1 

726172 


End of tape* 
"'L 


7. Interrupting and continuing a save operation. 

When DUMPER is printing a list of all file specs as it is 
saving the files, interrupt the operation, specify NO FILES, 
and continue the save. 
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ePUMFERpSP 

DUMPER>TAPE (DEVICE) TAPElKZD 
DUMP ER> RE WIND QTT) 

DUMPER>FILES(ZD 
D U M P E R > SAVE ( D I S K F I L E S ) CHE) 

DUMPER tape * 1 Volid TAPE1 ? ? Friday? 15-Jun-79 1159 
MI SC i < HUTCH IN!:! > 

ADEXMP . 1ST ♦ 1 (AS) ADEXMP . TST . 1 COKII 
BACKER. DOR. 1 (AS) BACKER. DOR. 1 COKII 
DUMF'l . TST « 2 <£™hD 
I n t e r r u p t i n £ ♦ ♦ ♦ 

(AS) DUMP1 ♦TST* 2 
D U M P E R > N 0 F I L E S QED 
HUM P E R > CONTIN IJ E («D 


T o 1 a 1 f :i. 1 e s d u m p e d ~ 2 4 
Total pastfes dumped « 57 
DUMPER> 


8. Checking the file contents. 

Verify that all files in all savesets have transferred 
correctly. 

gdijmperQED 

H IJ M P E R > TAPE ( DEV I C E > T A P E 1 tGED 

DUMPER>REUINDGeD 

D U M P E R > C H E C K ( A L L T A P E F I L E S ) GED 


DUMPER tape il : 1 Volid TAPE If y Tuesday? 26— Ju n— 79 1159 

%Compa re e r ro r y pad© 5 y f lie DUMP2 ♦ XMP ♦ 1 

% D .i f f e r e n e e i n ♦ F B C R E o f f i 1 e D U M P 2 ♦ X M P ♦ 1 

%D if Terence in ♦FBSIZ of file DUMP2*XMFM 

% D i f f e r e n c e i n ♦ F B W R T o f f i 1 e D IJ M P 2 ♦ X M P ♦ 1 

%D1fferer.ee in ♦ FBCNT of file DUMF’2 ♦ XMP ♦ 1 

%Dif ferer.ee in ♦FBUSW of file DLJMP2 ♦ XMP ♦ 1 

End of saveset 

DUMPER> CHECK (ALL TAPE FILES) (ZD 


DUMPER tape * 1 Valid TAP El ? v Tuesday? 26-Jun-79 1201 
End of saveset 

Dl.JMPER> CHECK (ALL. TAPE FILES)' (ZD 


DUMPER tape * 1 Volid TAF'El ? ? Tuesday? 26-Jun-79 1202 

End of save set 
DUMPEFO EXIT f^T) 

G? 
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9. Saving files from other directories to which you have access. 

Do a save of all files in all accessible directories on your 
connected structure. Note that this example of save requires 
a second tape. 


gdumperGID 

DUMPER>T APE (DEVICE) TAPEUChD 

dumper>rewindC^D 

DUMPER>SAVE (DISK FILES ) <*>*♦*♦* (AS) <*>*♦*.* CED 

DUMPER tape # 1 Vo I id T APE 1 v t Tuesday * 12-Jun-79 0847 
M I S C t < B A K E R ♦ S Y S E E R > 

MI SC ♦ <DAEMS> 

MI SC t <DBELL> 

M ISC KDBELL* MEMO > 

MI SC ♦ <DNEFF> 

M ISC X <D NEFF* LINK> 

MI SC ♦ CDNEFF ♦ TV> 

MI SC t <EIBEN> 

MI SC t <EKLUND> 

M I SC t <FECZK0> 

MISC:<GATULIS> 

MI SC:<GILBERT> 

MI SC t CGILBERT ♦ L INK> 

M I S C X < G I L B E R T ♦ MA C R 0 > 

MI SC:<GILBERT*NEW> 

M ISC X CGI L BERT ♦OLD >• 

MI SC ♦ <GRANT> 

MI SC :< HEMPHILL > 

M I S C t < H 0 F FMAN ♦ ARC H I V E > 

M I S C : < H 0 F F MAN ♦ FO R M S > 

M ISC ♦ <HQUK> 

MI SC ♦ < HUTCH I N S > 

M I SC ♦ < JCLARIO 
MI SC t <KECK> 

misc:<lscd> 

MI SC ♦ <LY0NS> 

I" M o u ri t i ri $ n e x t t a p e v o 1 u m e II 

DUMPER tape # 2 TAPE 2 v 9 Tuesday » 12-Jun-79 090:1. 

MI SC ♦ <L YONS ♦ DN87 ♦ 700-PDP8> 

MI SC t <MAGEATH> 

MI SC ♦ <MANUALS> 

MI SC ♦ < MATSON > 

MI SC ♦ CMATSON ♦ TEXT> 

M I SC ♦ < 0 RAN* D E C N E T > 

MI SC ♦ <PGRADA> 

MISC ♦ <R ♦ ACE> 

M I SC ♦ <REYNGLDS> 

M I S C { < S A U T E R ♦ N E T G E N > 

M I SC ♦ CSCHM I TT> 

MI SC ♦ < TOOLS > 

MI SC t <Y0DER> 

MISC* <Z I M A ♦ SPR> 


T o t a 1 f i I e s d u iti p e d 2 2 4 9 

Total pa sles dumped s:: 15704 
DUMPER> 
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10. Leaving DUMPER. 

Exit from DUMPER and check the number of volumes now in the 
tape set originally identified as TAPEl : . 


DUMPER>exitC™D 

©INFORMATION (ABOUT) VOLUMES (OF TAPE) TAFEltdin 
0 o 1 u iti e s o f t a p e s e t T A P E:.' 1 $ T A F : ’ E 1 y T A P I" 2 
© 


11. Recovering from a crash. 

If the system crashes while you are in the middle of a large 
save, mount another tape and assign it a number. Then 
restart the save at the file that was being processed at the 
time of the crash. 


gdumperGE D 

[iUMPER>T APE (DEVICE) TAPEl :G“D 
DUMPER>REWINDCfjp 

dumper>filesGIl) 

DUMPER>SAVE (DISK FILES )G"D 


DUMPER tape # 2 Yolid TAPEl r 

misc:<hutchins> 

ADEXMP ♦ TST ♦ 1 (AS) ADEXMP*TST*1 
DMPMSG ♦ RNO ♦ 1 (AS) DMPMSG ♦ RNO ♦ 1 
DUMP ♦ XMP ♦ 2 (AS) DUMP • XMP ♦ 2 
DUMP1 ♦ TST ♦ 1 (AS) DUMP1 ♦ TST ♦ 1 
DUMP2 ♦ TST « 1 (AS) DUMP2*TST*1 
DUMP3 ♦ TST ♦ 1 (AS) DUMP3*TST*1 
DUMP4 ♦ TST ♦ 1 (AS) DUMP4*TST*1 
DUMPER ♦ RNO * 1 (AS) 


Thursday y 5-Jul-79 1541 


COK! 
COK! 
COK! 
COK! 
COK ! 

cok! 

COK! 


% DEC SYSTEM- 20 NOT RUNNING 
System restart ins* v wait*** 

[From OPERATOR on line 21 1J SYSTEM IN OPERATION! 


Amount tape contap: /write-enabledCED 

C Mount Request CONTAP Queued y Reauest-ID 147! 
[Tape set CONTAP y volume CONTAP mounted! 
CCONTAP: defined as MTO ♦ ! 

0DUMPER 

DUMPER>TAF'E (DEVICE) CONTAP :C«D 
DUMPER>SSNAME CON. OF SAVEQtD 

dumper>rewindC«D 

BUMPER> INITIAL (EILESPEC) DUMPER . RNOCED 
DUMPER>SET TAPE-NUMBER (DECIMAL NUMBER) 2GED 
DUMPER>FILESGED 
DUMPER>SAVE (DISK FILES)C«D 


7-37 


THE DUMPER PROGRAM 


DUMPER tape * 2 Volid CONTAP? 
MISC ♦ <HUTCHINS> 

DUMPER ♦ R'NO ♦ 1 (AS) DUMPER ♦ RNO ♦ 1 
DUMPER ♦ TST ♦ 1 (AS) DUMPER ♦ TST ♦ 1 
EXAMP1 ♦ TST ♦ 1 (AS) EXAMP1.TST.1 
EXAMP2 ♦ TST ♦ 1 (AS) EXAMP2.TST.1 
EXDMP ♦ XMP « 1 (AS) EXDMP ♦ XMP ♦ 1 
I NV ♦ RNO ♦ 2 (AS) I NV . RNO » 2 
I NV * TST ♦ 1 (AS) I NO ♦ TST ♦ 1 
PHOTO ♦ EXE ♦ 1 (AS) PHOTO ♦ EXE ♦ 1 


Total files dumped = 15 
Total pades dumped ~ 294 
DUMPER> 


Note that any status commands (such as FILES) that were used 
before the crash, must be specified again. 


CON ♦ OF SAVE ? Thursday ? 5-Jul-79 1603 

cok: 

COK: 

cok: 

cok: 

cok: 

cok: 

cok: 

cok: 


Examples of RESTORE: 

12. Restoring a saveset saved on two volumes. 

Give the MOUNT TAPE command. When the first volume is 
mounted, define the set as MTA-DUMPER: . Run DUMPER and 
restore the entire saveset to disk. Request DUMPER to list 
the file specs as it restores them. 


©MOUNT TAPE SET1J /LABEL-TYPE X UNLABELED /WRITE-ENABLED /VOLIDS tTAPEl rTAPE2(«D 
CMount Request SET1 Queued? Reouest-ID 137: 

CTape set SET1? volume TAPE1 mounted: 

CSETi: defined as MTO ♦ : 

©DEFINE MTA-DUMPER J SETUQlD 

©dumperQll) 

DUMPER>REWINDC«D 

dumper>filesc«D 

DUMPER>RESTORE (TAPE FILES>G"D 


DUMPER tape * 1 Valid TAPE1 ? ? Monday? 2-Jul-79 0829 
Loadir.d file(s) into MISC : <HIJTCHINS> 

MISC ♦ <HUTCHI N5>B ACKER ♦ DOR ♦ 1 ? P777700 ? A341 (TO) BACKER ♦ DOR ♦ 1 COK II 

MISC J <HUTCHI NS>DMPMSG ♦ RNO ♦ 1 ? P777700 ? A341 (TO) DMPMSG ♦ RNO ♦ 1 COIC 

MISC t < HUTCHINS > D U M P ♦ XMP ♦ 1 ? P777700 ? A341 ( TO) DUMP ♦ XMP ♦ 1 COK: 

MISC : < HUTCHINS > D U M P 1 ♦ TST ♦ 2 ? P777700 ? A341 ( TO ) DUMP1 ♦ TST ♦ 2 COK: 

MISC J <HIJTCH I NS>DUMP2 ♦ TST ♦ 2 ? P777700 ? A34 1 ( TO ) DUMP2 ♦ TST .2 COK II 

MISC ♦ <HUTCHINS>DUMP2 .XMP.1?P777700?A341 (TO) DUMP2*XMP»1 COK: 

MISC ♦ <HUTCHI NS>DUMP3 .TST ♦ 2 ? P777700 ? A341 (TO) DUMP3 ♦ TST ♦ 2 COK II 

MISC t <HUTCHI NS>DUMP3 ♦ XMP ♦ 1 ? P777700 ? A341 (TO) DU MP3 ♦ XMP ♦ 1 COK: 

C Mount i rid next tape volume: 

DUMPER tape # 2 Volid TAPE2? ? Monday? 2-Jul-79 0843 

MISC ♦ <HIJTCHI NS>FILE1 ♦ RNO ♦ 6 ? P777700 ? A341 (TO) FILE1.RN0.6 COIC 

MISC t CHUTCHI NS>FILE2 ♦ RNO ♦ 1 ? P777700 ? A341 (TO) FILE2 ♦ RNO ♦ 1 COIC 

MISC:<HUTCHINS>INV.RN0.2?P777700?A341 (TO) INV.RN0.2 COKTJ 
MISC J CHUTCHI NS> PHOTO ♦EXE.1?P777700?A341 (TO) PHOTO ♦ EXE ♦ 1 C0K11 


End of saveset 
HUM PER > 
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13. Restoring a single file. 

Specify a single file of a saveset to be restored to disk. 


enuMPERCED 

DUMPER>TAF'E (DEVICE) SETljQED 
DUMPER > R E W I N D CEED 
nUMPER>F:[L..ESC*jD 

DUMPER> RESTORE (TAPE FILES) FILE2.RN0.* (TO)QID 


DUMPER tape* 1 Volid SET1 > » Thursday* 5-Jul-79 1029 

Loading file(s) into MISC5<HUTCFIINS> 

MISC ♦ <HUTCHINS>FILE2 . RNO * 1 JP777700 5 A341 (TO) FILE2.RN0.1 COId 

End of saveset 
DUMPER> 


14. Restoring files saved from another structure. 

Restore all files that were saved from a mountable structure 
( such as MISC : ) . 


@dumperC«D 

DUMPER> T APE (DEVICE) SETISCUD 

dumper>rewindC«D 

DUMPER>FILESQED 

DUMF'ER> RESTORE (TAPE FILES) MISC J<HUTCHINS>* . * (TO iCEED 


DUMPER tape 4 1 Volid SET1* * Thursday 
Loading file(s) into MISC * <HUTCHINS> 
MISC 5 <HUTCHINS>F ILE1 . TXT . 1 i P777700 5 A3 4:1 
MISC* <HUTCHINS>F ILE2. TXT ♦1JP7777005A341 
M ISC 5 <HUTCHINS>FILE3 . TXT . 1 ) P777700 5 A34 1 

End of saveset 
DUMF'ER> 


15. Restoring multiple files. 

Restore only files with file types .RNO and .DMP. 


* 5- Jul--79 0833 

(TO) MISCJFILEl.TXT.l 
(TO) MISCJFILE2.TXT. 1 
(TO) MISCtFILE3.TXT. 1 


e m)HPERf~) 

DUMPER> TAPE (DEVICE) SETllQED 
DUMF'ER>REWINDQiD 

dumper>filesC«D 

DUMPER> RESTORE (TAPE FILES) * , RNO r * . DMF'CEED 


COKII 

COId 

COId 
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DUMPER tape # 1 Volid SET 1. y v Monday. 2-Jul~79 0832 
Loading file(s) into MISC:<HUTCHINS> 

MI SC t <HUTCHINS>DMPMSG ♦ RNO ♦ 1 ? P777700 5 A34.1 ( TO ) DMPMSG ♦ RNO ♦ 1 II0KU 

MISC ♦ <HUTCHINS>FILE1 ♦ RNO ♦ 6 $ P777700 ? A341 (TO) FILE1 ♦ RNO ♦ 6 COKU 

MI SC ♦ <HUTCHINS>FILE2 ♦ RNO ♦ 1 ? P777700 . A341 (TO) FILE2.RN0.1 IIOKU 

MISC ♦ <HUTCHINS>INV ♦ RNO ♦ 2 5 P777700 ? A341 (TO) I NO ♦ RNO ♦ 2 II OK. I 

MISC J < HUTCHINS > D U M P 1 ♦ DMP ♦ 1 % P777700 5 A341 ( TO ) DUMP! ♦ DMP ♦ 1 COKU 

MISC J < HUTCHINS > D IJ M P 2 ♦ DMP ♦ 1 ? P777700 5 A341 ( TO ) DUMP2 ♦ DMP ♦ 1 I" OICJ 

MISC t <HUTCHINS>DUMP3 ♦ DMP ♦ 1 J P777700 J A341 ( TO ) DUMPS ♦ DMP ♦ J. II OKU 


End of saveset 
DUMPER> 


16. Restoring 
connected 

files saved 
directory. 

from 

another directory 

into 

your 

Specify that files saved 

from 

the directory PS: 

<ADLEY> 

be 


restored to your connected directory, MISC : <HUTCHINS> . 


bdumperQED 

DUMPER>TAPE < DEVICE ) TAPEUCED 

dumper>rewindC ED 
dumper>filescED 

DUMPER> RE STORE (TAPE FILES) PS : < ADLF Y>* ♦ * ♦ * (TO) M I SC I <HU TCH I NS>* ♦ * . *CED 


DUMPER tape * 1 Volid TAPE1 . . Monday. 9-Jul-79 1505 
Loading file(s) into MISC J <HUTCHINS> 

PS ♦ <ADLEY>COMMANDS ♦ TV ♦ 6 » P777700 > A34 1 (TO) MISC ♦ <HUTCHINS>COMMANDS *TV ♦ 6 COKU 
PS J <ADLEY>EMACS ♦ IN IT *25 P777700 5 A341 ( TO ) MISC J <HLJTCHINS>EMACS ♦ INIT *2 I" OKU 

PS J < ADLEY>LOCI N ♦ CMD *10 5 P777700 ? A341 ( TO ) MISC J <HUTCH INS>L0G IN ♦ CMD ♦ 1 0 C OK II 

P S : < A D L E Y > MAIL *TX T ♦ 1 . P777700 ? AMONITOR ( T 0 ) MISC J < H U T C H I N S > M A I L ♦ T X T ♦ 1 C 0 K U 

End of saveset 
DUMPER> 


17. Restoring files accessed within a period of time. 

Restore only files that were accessed between l-June-79 and 
15-July-79. Also direct DUMPER to take the file account from 
tape . 


0DUMPERC ED 

DUMPER>T APE (DEVICE ) TAPEUCED 

dumper>rewindCED 

dumper>filesCED 

DUMPER>ACCOUNT (OF RESTORED FILES FROM) TAPECED 
DUMPER>ASINCE (DATE AND TIME) 6-1-79 8:00AMCED 
DUMP ER> A BE FORE (DATE AND TIME) 7-15-79 5J00PMCED 
DUMPER>RESTORE (TAPE FILES >CED 
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DUMPER -tape * 1 Volid TAPE! x x Wednesday ll-Jul-79 1204 
Loading filets) into MISC J <HUTCHINS> 

MIBC : <HUTCHINS>DMPMSG ♦ RNO ♦ 1 x P777700 x A341 ( TO ) DMPMSG ♦ RNO ♦ 1 IT OKI! 

MISC i < HUTCHINS > D U M F‘ ♦ XMP ♦ 1 x P777700 x A341 ( TO ) DUMP ♦ XMP ♦ 1 l OKI 
MISC : <HUTCHINS>DUMPER ♦ RNO ♦ 1 x P777700 x A341 ( TO ) DUMPER ♦ RNO ♦ 1 II OK II 

MI SC ♦ <HUTCFJINS>EXDMP ♦ EXE ♦ 4 x P777700 x A341 <T0) EXDMP.EXE *4 COKII 

MISC t <HUTCHINS>EXDMP ♦ GXE * 3 x P777700 x A341 ( TO ) EXDMP * QXE ♦ 3 ZQK1 

MISC J <HUTCHINS>INV ♦ Fv'NO ♦ 2 x P777700 x A341 (TO) INV*RN0*2 COKD 


End of saveset 
DUMPER> 


18. Skipping over existing savesets. 

Rewind the tape and skip to the third saveset. Restore the 
files from the third saveset. 


BDUMPER fTiT) 

DUMPER>TAPE ( DEVICE ) SETUCHD 

dumper>rewindQE) 

DUMPER>SKIP < NUMBER OF SAVESETS) 2C«D 

DUMPER TAPE * 1 VOLID SET1? ? Thursday? 24--May-79 0839 

DUMPER tape # 1 Volid SET1? ? Thursday? 31-May-79 0:1.427 

DUMPER tape * 1 Volid SET1? ? Tuesday? 5-Jun-79 0940 

dumper>filesC«D 

DUMF'ER> RES TORE (TAPE FILES )C«D 


DUMPER tape # 1 Volid SET! ? ? Tuesday? 5-Jun-79 0940 
Loading file<s> into MISC 5 <HUTCHINS> 

M I SC S <HUTCH1NS>DMPMSG . RNO . 1 ? P777700 ? A34 1 ( TO) DMPMSG . RNO . 1 COK 3 

MISC { <HUTCHINS>FILE1 . RNO . 6 ? P777700 ? A34 1 (TO) FILE1 . RNO . 6 C0K3 

MISC 1 <HUTCHINS>FILE2 . RNO . 1 ? P777700 ? A341 (TO) FILE2.RNQ.J COK 3 

MISC »<HUTCHINS>INV . RNO . 2 ? F'777700 ? A341. (TO) INV.RN0.2 COK 3 

End of saveset 
DUMPER> 


19. Switching to the second volume of the tape set. 


When you do not see the file you want on 
rewind it and switch to the second volume 
needed, exit from DUMPER, and dismount the 
specifying the tape set name. Note 
MTA-DUMPER: command is still effective 
volume in the set. 


the first tape, 
Restore the file 
second volume by 
that the DEFINE 
with the second 
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DUMPER> REWIND SWITCHING (TO VOLUME NUMBER) 2 CUD 
BUM PER> R E W I N dC“D 

DUMPER> PRINT (DIRECTORY OF TAPE ONTO FILE>C«D 

DUMPER tape * 1 Vo lid TAPE1 » r Wednesday y 11- Ju 3.-79 1151 
file 


MI SC J CGRANT . SYSERR>SYR 12-20 . DOC . 1 
(file continued from previous reel) 

MI SC J CGRANT ♦ S Y S E R R > S Y R 1 2 A . DOC . 1 
MI SC J CGRANT ♦ SYSERR>SYRLIB * MAC * 23 
MI SC J CGRANT . SYSERR>SYRLOW . MAC . 1 1 
MI SC J CGRANT ♦ SYSERR>SYRUNV . MAC ♦ 37 
MI SC J CGRANT . SYSERR>SYSERA ♦ EXE . 1 
M ISC J CGRANT . SYSERR>SYSERA ♦ MAC . 7 
M ISC : CGRANT ♦ SYSERR>SYSERB . EXE ♦ 1 

(CTRLff) 

Interrupting ♦ ♦ . 

DUMPER> REWINDCtED 
%Do you really want to abort your interrupted command? Y ( m 1 

DUMPER>.RE STORE (TAPE FILES) MISC : CGRANT . S Y S E R R > S Y S E R A ♦ MAC . * (TO) MISC:<HUTCHINS>C“D 


last write size (pastes) checksum 


15-Aust-78 

0916 

3 

22-Aus$-78 

0951 

13 

2- Jul-79 

1436 

48 

2-Jul-79 

1436 

5 

3~ Jul-79 

1346 

91 

3- Jul-79 

1531 

50 

2- Jul-79 

1436 

30 

3- Jul-79 

1531 

60 


©DISMOUNT TAPE TAPEltQiD 

CTape dismounted r logical name TAPE1 * deleted!] 
(? 


7.6 THE PRIVILEGED USER 

As a privileged user, you can perform operations beyond the 
capabilities of a nonpr ivil eged user. These operations include backup 
and restoration of all system files, archiving, and migrating. Below 
is a list of switches, commands, and defaults to which only privileged 
users have access. 


• As part of the SAVE command, you may append the following 
swi tches : 

/FULL-INCREMENTAL to request that DUMPER save all 
specified files and mark each file as having been saved 
on tape. All information is preserved regarding the 
number of times the file has been saved. This is the 
command for a weekly system backup of all files. 

/INCREMENTAL: n to request that DUMPER save all files 
that have either not been saved at least n times, or 
have been modified since the last INCREMENTAL or 
FULL-INCREMENTAL run. This is the command for a daily 
backup of all files. 
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NOTE 

If a save has not previously 
been done with the 
FULL-INCREMENTAL switch, 
specifying the INCREMENTAL 
switch will have the same 
results as specifying 
/FULL-INCREMENTAL ( i . e . , 
DUMPER saves all files) . 


/NOINCREMENTAL to request that DUMPER not perform an 
incremental save. In this case, DUMPER saves all files, 
but does not preserve any information regarding the 
number of times the file has been saved. 
(/NOINCREMENTAL is the default.) 

/ARCHIVE to request that DUMPER save only files that 
have been marked for archival. 

/MIGRATE to request that DUMPER save only files that 
have been marked for involuntary migration by the REAPER 
program (refer to the T0PS-2Q Operator's Guide ) . 


NOTE 

In using any of these 
switches, you do not have 
the option of renaming files 
from disk to tape. A file 
transferred to tape has the 
same name as the file on 
disk . 


© You can RESTORE or RETRIEVE files from an archive or migration 
tape . 

© You can use the CREATE command to recreate an entire directory 
that has been deleted. 

© When you type SAVE or RESTORE with no specified directory, the 

default is <*> on the connected structure. (For a 

nonpr iv ileged user, the default is the connected directory and 
structure . ) 

© When you restore files, the last writer string of the file on 

disk is set to the name of the last writer at the time of the 

save. (For a nonpr ivileged user, the last writer string is 
set to the name of the user doing the restore. 


Sections 7.6.1 through 7.6.5 describe the use of these commands and 
switches. This manual does not include step-by-step procedures for 
performing a system backup, restore, archival run, or migration run. 
For details, refer to the TQPS-20 Operator's Guide . 
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7.6.1 Backing Up System Files and/or Other Users' Files 


To minimize loss of disk files, you should put backup copies of all 
files on magnetic tape. In many installations, this should be done on 
a daily basis. (for details, refer to the TOPS-20 System Manager's 
Guide . ) 

Backup is done with the SAVE command. As a privileged user you have 
the option of doing one of three types of saves by using SAVE plus 
either /FULL-INCREMENTAL, /INCREMENTAL, or /NOINCREMENTAL . 

A sample backup routine for an installation might be: 

Friday night: Run DUMPER to save all system files and 
directories using /FULL- INC REMENTAL. 

All other nights: Using /INCREMENTAL : 2 , save all files with 
changes made since the save of the previous night. This allows 
you a margin of error in recovering files that have been 
inadvertantly deleted and expunged. 

The incremental runs can be made either more or less frequently at the 
discretion of the installation. In the event of -a total file system 
loss, the installation can restore the disk to the state of the most 
recent incremental by first restoring the full-incremental tapes to a 
fresh set of packs, and then restoring any incremental tapes that were 
made since the full-incremental. 

If the installation desires two sets of backup tapes (to gain an extra 
measure of safety), the above procedure can be modified as follows: 

Friday night: Run a /FULL-INCREMENTAL, followed immediately by 
another /FULL-INCREMENTAL. This creates two sets of full-save 
tapes. 

All other nights: Make two consecutive runs with /INCREMENTAL : 2 . 
This creates two identical sets of incremental save tapes, unless 
any file has been changed between saves. 

If your installation has structures other than PS:, the public 
structure, it is important to back up files on all structures. It is 
advisable to use a different tape for each structure. Furthermore, it 
is important to use a different tape for every function: backup, 
migrate, and archive. 

Example: 

Mount two tapes or tape sets. On the first tape, save all files 
in all directories on the public structure, PS:. On the second 
tape, save all files in all directories on the private structure, 
MISC: . 


0ENABLEQID 

$MOUNT TAPE SAUEIJ /LABEL-TYPE X UNLABELED /URITE-ENABLED Q^T) 
CMount Request SAUEi Queued* Reeuest-ID 2833 
II T 3pe set SAUEl* volume SAUE1 mourited3 
CSAVEl ♦ defined as MT0J3 
♦ DUMFERfSP 

BUMPER >T APE (DEVICE) SAVE1J QiD 
DUMPER>SSNAME PS : -FULL SAUEQlD 

dumper>reuind(«D 

DUMPER>SAVE (DISK FILES) /FULL.-- INCREMENTAL PS 
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DUMPER tape * 1 Volid SAVE! > PS J -FULL SAVE 9 Wednesday* ll-Jul-79 1313 
PS ♦ <1EIBEN> 

PS:<1STUDENT> 

PS:<ABEL> 

PSJCACARLSON> 

PS ♦ <ACCOUNTS> 

PS : CACE> 

PS : CACTI 0> 

PS J CABLE Y> 

PS : <ALLEN> 

P S ♦ < ANDERSON > 

PS : < API. FO- 
PS i C APLSF> 

PS ♦ CARNQLD> 


dumper>exit® 

$ MOUNT TAPE SAVE2 l /LABEL-TYPE X UNLABELED /UR I TE - ENA PLEDG'D 
C Mount Re «uest SAVE2 Queued* Reeuest-ID 2873 
II Tape set SAVEl 2* volume SAVE2 mounted.1 
CSAVE2J def ined as MTO ♦ 1 

<ldumpeeGlD 

HUM P E R > TAPE (DEVICE) S A V E 2 : GiD 
DIJMPER> SSNAME MISC t -FULL SAVEGD 
DUMPER> REWIND® 

DUMPER> SAVE (DISK FILES) /FULL.-- INCREMENTAL NISC*<*>*«t»*C£J 

DUMPER tape # 1 Volid SAVE2* MISCJ-FIJLL. SAVE * Wednesday* ll-Jul-79 1324 
MISC ♦ <1BELANGER> 

M I SC ♦ < 1 E I BEN> 

MISC* C2BEL ANGER> 

MISC ♦ <2EIBEN> 

MISC ♦ CACE> 

MISC ♦ <ADLEY> 

MISC ♦ <APL.B> 

MISC* < A P L S F > 

MISC ♦ <BAKER> 

MISC : CD AKER * SYSERR> 

MISC* CDATOR> 

MISC ♦ CBELANGER> 


DUMPER>EXIT® 

♦ 


If the system crashes 
migrating files, you 
system is restarted, 
type the 
Example 11 


DUMPER commands 
in Section 7.5.5.) 


while you are saving, restoring, archiving, or 
do not have to start from the beginning when the 
a nonpr ivileged user, enter DUMPER and 
INITIAL and SET TAPE-NUMBER. (Refer to 


As for 
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7.6.2 Restoring Files and Directories from System Backup Tapes 

If a user accidentally deletes files from the disk area, he will want 
to restore them from backup tapes. In many installations, you as a 
privileged user or operator must restore these files. 

To fill his request, mount the full save tape (of files saved on a 
weekly basis) and restore the requested files. Then, if necessary, 
mount the incremental save tape (of new or changed files saved on a 
daily basis) and restore the remainder of files in the user's request. 
The RESTORE command is the same as for a nonpr ivileged user. You must 
specify the source in order to transfer the files of the user who made 
the request. 

Example : 


BDUMFERr«n 

DUMPER>TAPE (DEVICE) TAPElGsD 
DUMPER>REUINDQlD 

DUMPER>FILESQFT) 

DUMPER> RESTORE (TAPE FILES) MISC! <HUTCH I NS>* ♦ RNO * * (TO) MISC ! <HUTCHINS>(«r) 


DUMPER tape * 1 Valid TAPE It y Tuesday* 5-jun-79 0940 
Losdind file(s) into MISC!<HUTCHINS> 

MISC : <HUTCHINS>DMPMSG ♦ RNO ♦ 1 y P777700y A341 ( TO ) MISC ! <HUTCHINS>DMPMSG ♦ RNO ♦ 1 COKT 
M I S C ! < H U T C H I N S > DUMPER ♦ RNO ♦ 1 y P777700 y A341 (TO) M I S C t < H U T C H I N S > D U M P E R ♦ RNO ♦ 1 C 0 K 3 
M I S C J < H U T C H I N S > FILE1 ♦ RNO ♦ 6 y P777700 y A341 (TO) MI S C ♦ < H IJ T C H I N S > F I L E 1 ♦ RNO ♦ 6 C 0 K 3 
MISC! <HUTCHINS>F ILE2 ♦ RNO ♦ 1 y F'777700 * A341 (TO) MISC ! <HUTGHINS>FILE2 ♦ RNO ♦ 1 COKD 
MISC! <HUTCHINS>INV ♦ RNO ♦ 2 y P777700 y A343. (TO) MISC! < HU T C H I N S > I N V ♦ R N 0 ♦ 2 EOKJ 

End of. save set 
DUMPER> 


If a user's entire directory is accidentally deleted, you can restore 
it with the DUMPER command CREATE. Having entered DUMPER, type CREATE 
before RESTORE. As DUMPER restores all files and directories, it 
restores (creates) the deleted directory exactly as the directory was 
saved. (When you do a save with privileges enabled, all directory 
information is auotmatically saved.) 


7.6.3 Archiving Marked Files 

If your installation is using the archive/virtual disk system for 
off-line storage of files, the installation establishes a schedule 
under which it runs the DUMPER program to copy files marked for 
archiving onto tape. User requests to archive files do not appear at 
operator command level. However, you can use the TOPS-20 command 
INFORMATION ARCHIVE-STATUS DSK* :<*>*.*.* to display the files that 
users have requested to be archived. 


NOTE 

DSK*: refers to all mounted structures 

currently accessable to your job. 
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$ INFORMATION (ABOUT) ARCHIVE-STATUS (OF FILES) DSK* 5 <*>*.*. *C*E) 
< A L. L E N > CAD. C M D . 1 Mi si rat i o n proh i b i 1 e d 

< AL..L.E N > C 0 MAN D . C M D .1 Mi si r s 1 i o n p r o h i b i t e d 
<BERENSON>X . .1 Archived 

<BLOUNT>FILE~TO~ ARCHIVE . TXT . 1 Archived 

< D B E L L > I N V I S I B L E - L 0 G I N . C M D . 1 M i si r a t i o n p r o h i b i t e d 

< D B E L. L > MAIL . TXT . 1. Mi g r a t i o n p r o h i b i t e d 
< E N G E L > A . A . 1 Migr a t i o n e r o h i b i t e d 

< E N G E L.. > B A T C H . C M B . 1 M i g r a t i o n proh i b i t e d 

< G L X L I B > F 0 0 . L 0 G . 1 Arc h i v e d 
<GLXL I B>FOO . MAC . 1 A rch i ved 

< H E L. L. I W E I... L. > C 0 MAND.CMD. 3 M i si r a t i o ri p r o h i b i t e d 
CHESS . DOOUSAGE . TXT ♦ 1 Migration prohibi ted 

< H E S S , D 0 C > USGREC . FRM . 1 Mi sir a t i o n p rohib i t e d 
< J A B L 0 N S K Y > T E S T . EXE , 1 Archived 

< K I R S C H E N > FOG. 0 F F L I N E . 1 A r c h i v e d 
< L A U B E R > MAIL.TXT. 1 M i si r a t i o n p r o h i b i t e d 
< L C A M P B E L L > C A S E .1.5 A rch i ved 

< L C A M P B E L L . D E C N E T > 0 L D-NMAIL. . REL . 1 Archive r e a u e s t e d 

< L Y 0 N S > S E L F . T X T . 1 Mi gratia n p r o h i b i t e d 

< LYONS > TEAMS. WRD.l Mi si rat i o n p r o h i b i t e d 
<MCL.EAN>ATOG . WDS . 1 Migration prohibited 
COPERATOFOSYSERR . LOG . 1 A rch i ved 

COSMAN . SOU R C E" S > >J 3 N E W . RNO . 1 Archive requested 

< R . A C E > P . F I L . E X E . 2 Archive r e a u e s t e d 

< R E I L L Y > ABB REV . D E F N S . 1 M i g r a t i o n p r o h i b i t e d 
< S A L A S > 1 1 0 6 7 8 . F R 1 .1 A r c hived 
<SALAS>SYMSUB . MAC . 1 Archived 

< S N Y D E R . B E I G E B 0 0 K > C F< I S S . R N 0.1 A r c h i v e d 
M I S C J < B R 0 W N > B A T C H 1 . C T L. . 1 Arc h i v e d 

M I S C « < B R 0 W N > B A T C H 2 , C T L . 1 A r c hive d 

MISC J <GILBERT>DDT .SORTED-SYMBOLS-MAC , 1 Archived 

MI SC t < G I L B E R T > 0 L D - R EL EASE-4- F I L D D T . M A C .1 A r c h i v e d 

M I S C t < H U T C H I N S > A D E X M P . T S T . 1 A r c h i v e d 

M ISC J < H U T C H I N S > D U M P 1 , D M P .1 A r c h i v e r e a u e s t e d 

MISC : < H IJ T C H I N S > D U M P 1 . TST . 1 Archived 

MI SC t < H U T C H I N S > D U M P 2 . D M P . 1 Archive r e o u e s t e d 

M I S C : < H IJ T C H I N S > D U M P 2 . T S T . 1 A r c h i v e d 

M I SC \ CLATT A > MOO BE! . TXT . 1 A rch i ved 

MIS C 5 < L S C D > MAI L . 0 L D . 1 A r c h i v e d 

M I S C : < LYONS > D D T . D I R E C T 0 R Y . 1 M i g r a t i o n proh i b i t e d 
M I S C : < L Y 0 N S > D N 8 7 . D I R E C T 0 R Y . 1 M i g r a t i o n p r o h i b i t e d 

% 


You then mount a tape used only for archiving and run DUMPER. 


DUMPER> SAVE (DISK FILES)/ ARCHIVE STR {<*>*. jKCHD 


If no file spec is given with the command, all files marked 
archiving on the connected structure are transferred to tape. 

At the beginning of the archive run, DUMPER asks: 


Is this a new tape? 

If you answer YES, DUMPER asks: 


Are sou sure? 


for 
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If you answer YES again, DUMPER writes at the beginning of the tape, 
erasing anything that is currently written on it. If you answer that 
this is not a new tape, DUMPER positions the tape after the last 
saveset and appends new files to the existing files. 


When the marked files have been tran 
reached, DUMPER indicates that the 
you that Pass 2 has begun. Pass 2 i 
should delete the file contents, 
You must mount a second tape and typ 
The purpose of the second tape i 
them as on the first tape, and then 
from disk, unless the user has 
retained. The files are then invisi 


sferred, or the end-of-tape is 
operation is complete and notifies 
s a check to determine if DUMPER 
and to update the archive status, 
e another SAVE/ARCHIVE command, 
s to write the files again, verify 
delete the contents of the files 
requested that the contents be 
ble in the user's directory. 


Example : 


BDUMFER 

DUMPER>TAPE ( DEVICE ) ARCH 1 :QeT) 

D U M P E R >R E W I N Pf^D 
IUJM P E R > FILE SC«D 

BUMPER>SAVE (DISK FILES) /ARCHIVE MISC J <HUTCHINS>* . * . * (AS)ChD 
$Is this a new tape? Y ( »ct ) 

$Are you sure? Y ( ,EI ) 

DUMPER tape Valid ARCH 1 , Save set# 2v > Tuesdays- 3--Jul~79 0908 
Pass 1 started 
MISC:<HUTCHINS> 

D U M P 1 ♦ D M P ♦ 1 (AS) D IJ M P 1 ♦ D M F : * ♦ 1. C 0 K II 

DUMP2 ♦ DMP ♦ 1 < AS ) DUMP 2 ♦ DMP ♦ 1 C OK 1 

D U M P 3 ♦ D M P ♦ 1. (AS) D U M F : ’ 3 ♦ D M P ♦ 1 C 0 K 1 

F : ' a s s :L e o iti p 1 e t e d ♦ 

S a v e s e t c o iti p 1 e t e ♦ T a p e r e a d y f o r s to r a sJ e ♦ 

Pass 2 started# 

P a i!> s 2 c o m p 1 e t e d ♦ 


T o t a I f i 1 e s d u in p e d » 3 
Total pades dum ped 3 
D U M P E R > EXIT (~«t~) 

^DISMOUNT TAPE ARCHltCsD 

CTape dismounted » logical name a r chi 5 deleted"! 

$M0UNT TAPE ARCH2* /WRITE-ENABLEDGE) 

E Mount Reeuest ARCH 2 Queued » Reauest-ID 14011 
CTape set ARCH2r Volume ARCH2 mounted"! 

E ARCH2 * defined as MTU 1 

$dumperc«D 

DUMPER>TAPE (DEVICE) ARCH2 ! (V) 

D U M P E R > REWIND ( »i ) 

dumper>filesG1D 

DUMPER>SAVE (DISK FILES) /ARCHIVE MISC J <HUTCHINS>* . * . * (AS)QE) 
$ I <r> this a new tape? Y ( »et ) 

$A r e sou su re? Y C ™ ) 
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DUMPER tape Uolid ARCH 2 v Save set# 3y 9 Tuesday v 3-Ju 1-79 0919 
Pass 1 started 
MISCS<HUTCHINS> 

DUMP! * BMP * 1 < AS ) DLJMPl ♦ BMP ♦ 1 COKD 

DUMP2 * BMP ♦ 1 ( AS ) BUMP2 * BMP ♦ 1 COKl 
DUMP 3 ♦ BMP ♦ 1 (AS) BUMP3 * DMP ♦ 1 C0K3 

F : ' a s s 1 e o iti p 1 e t e d ♦ 

S a v e s e t c o m p 1 e t e ♦ T a p e res d y f o r s t o r a <♦* e ♦ 

Pass 2 started* 
p a s s 2 c o iyi p 1 e t e d ♦ 


Total files dumped - 3 
Total pa files dumped = :: 3 
DUMPER>©k itC«D 


WARNING 

When DUMPER archives or migrates files, 
it numbers the two tapes as Save set #2 
and Save set #3. 


7.6.4 Migrating Files 

According to the procedures of your installation, you can periodically 
migrate files (i.e., copy them onto tape and delete them from disk). 
This is not done at the user's request. It is a means of clearing 
disk space of files that have not been referenced within a specified 
period of time. It is also a technique for returning directory disk 
usage to within its quota. 

You must specify a time period with the MIGRATE command to the REAPER 
program. When REAPER is run, it marks, for involuntary migration, all 
files that have not been used during that time period. 

Having run REAPER, you then run DUMPER and use the command SAVE (DISK 
FILES) /MIGRATE. This dumps all files marked for migration onto the 
mounted tape. 

As with archiving, you use two tapes when migrating files. This 
provides a backup system in case one tape is bad or misplaced. DUMPER 
then follows the same routine as with archiving. It first asks if 
this is a new tape. When the files have been successfully migrated to 
the second tape, their contents are deleted from disk and DUMPER sends 
mail to notify him that his files have been migrated. The files then 
have an ;OFFLINE status in the user's directory. 
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7.6.5 Retrieving or Restoring Archived and Migrated Files 

Once a user requests that the file be archived or migrated, he cannot 
access it because its contents have been deleted from disk (unless he 
has specified the subcommand RETAIN with the archive request). Only 
the FDB remains. The user can, however, request a retrieval of a file 
by using the TOPS-20 command RETRIEVE. This creates an entry in the 
system retrieval queue. (The queue can be displayed by typing the 
INFORMATION RETRIEVAL-REQUESTS command.) All retrieval requests are 
kept in order according to the archived or migrated tape information. 
This information consists of the volume identification, the tape 
saveset number, and the tape file number. When you are ready to 
process the retrieval request queue, run DUMPER and use DUMPER's 
RETRIEVE command: 


DUMPER> RETRIEVE (FILES ) file speeQFT) 

If the file spec is omitted, DUMPER processes all requests in the 
queue. If a file spec is included, only those files that match the 
file spec are processed. (The file spec may include wildcards.) For 
example : 


RETRIEVE (FILES) M I S C : < H U T C H I N S > * ♦ T S T G“D 

When DUMPER selects a file or files for retrieval, it submits a mount 
request for the tape containing the file(s) . After you or the 
operator have mounted that tape, DUMPER begins the retrieval process. 
When the files have been retrieved, DUMPER notifies the requestor. 


NOTE 

When processing retrieval requests, you 
do not need to type the TOPS-20 command 
MOUNT TAPE or the DUMPER command TAPE. 
DUMPER automatically requests the tapes 
it needs. 


If you cannot find the appropriate tape, type the OPR command CANCEL 
MOUNT-REQUEST. The system requeues the request using the information 
from the second tape. If the file cannot be recovered from either 
tape, the request is deleted and the requestor is notified. 

Assuming all files can be found, only one RETRIEVE command is 
necessary to process the retrieval queue. If the files to be 
retrieved are on different tapes, DUMPER automatically unloads the 
mounted tape and submits a mount request for the next tape it needs. 


WARNING 

If you type RETRIEVE when there are no 
retrieval requests in the queue, DUMPER 
waits indefinitely. Whenever possible, 
check the queue (with the TOPS-20 
command INFORMATION RETRIEVAL-REQUESTS) 
before typing RETRIEVE. 
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If a user deletes the filename from his directory, and therefore the 
File Descriptor Block (FDB) , and then wishes to retrieve the file, you 
must use the RESTORE command. When you locate the file, you can 
restore it with or without the tape information. This information 
indicates whether the file is archived or migrated, and if so, onto 
which tapes. If you do not wish to restore this information with the 
file, type the command RESTORE/NOTAPE-INFORMATION. To reinstate the 
transfer of this information with the file, type the command 
RESTORE/TAPE-INFORMATION (this is the default) . 


7.7 DUMPER COMMANDS 

This section contains an alphabetical list of all DUMPER commands. 
Each listed command includes a brief description, command type 
(Status-Setting, Action, or Tape-Positioning) , and description of 
optional arguments. Where applicable, there is an indication that the 
command is for privileged users only. 


ABEFORE (DATE AND TIME) date time Status-Setting 

Saves or restores only files that were typed, printed, or read 
(as maintained by . FBREF) before the specified date and time. 
Default: Date - none; Time - 00:00:01 


ACCOUNT (OF RESTORED FILES FROM) account Status-Setting 

Restores files with either the system (SYSTEM-DEFAULT) account or 
the account stored with the file (TAPE) . 

Default: TAPE 


ASINCE (DATE AND TIME) date time Status-Setting 

Saves or restores only files that were typed, printed, or read 
(as maintained by .FBREF) since the specified date and time. 
Default: Date - none? Time - 00:00:01 


BEFORE (DATE AND TIME) date time Status-Setting 

Saves or restores only files that were created or modified (as 
maintained by . FBCRV and . FBWRT) before the specified date and 
time. 

Default: Date - none? Time - 00:00:01 


CHECK (ALL TAPE FILES) Action 

Checks every file in the current saveset against the contents and 
file descriptor blocks (FDB's) of the corresponding files on 
disk. Corresponding files must have the same name, structure, 
directory, type, and generation number for the check to be made. 
(Refer to Table 7-3 for a list of possible differences.) 


[NO] CHECKSUM (FILES) type Status-Setting 

Activates or suppresses checksumming. Two types may be 
specified: SEQUENTIAL (for INTERCHANGE mode) or BY-PAGES (that 

checks every word of every page) . 

Default: NO CHECKSUM 
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CONTINUE Action 

Continues a CHECK, RESTORE, RETRIEVE, SAVE, or any 
Tape-Positioning command, after you have interrupted the command 
with CTRL/E. 


[NO] CREATE (DIRECTORIES FROM TAPE DATA) Status-Setting 

Creates or does not create user directories from directory 
information on the tape. 

Default: NO CREATE. 

(Privileged User Only) 


CTRL/E Action 

Halts the action of a CHECK, RESTORE, RETRIEVE, SAVE, or 
tape-positioning command. DUMPER responds with INTERRUPTING... 
and its prompt. If you type anything other than a status-setting 
command, DUMPER asks if you want to abort the interrupted 
command . 


DENSITY (OF MAGTAPE) n Status-Setting 

Sets the tape density to the given number of bits per inch 
(bits/in): 200, 556, 800, 1600, 6250, or JOB-DEFAULT (set by the 

system command SET TAPE DENSITY) . 

Default: The density listed in the TOPS-20 command INFORMATION 

(ABOUT) TAPE-PARAMETERS . 


[NO] DIRECTORIES Status-Setting 

Reactivates or suppresses printing, on your terminal, directory 
names as DUMPER saves or restores each directory. 

Default: DIRECTORIES 


EOT Tape-positioning 

Positions the mounted tape at the end of the last saveset written 
on the tape. DUMPER prints all existing saveset names and the 
message: 

TAPE POSITIONED AFTER LAST SAVESET 


EXIT Action 

Exits to TOPS-20 command level. (Refer to the QUIT command.) 

[NO] FILES Status-Setting 

Reactivates or suppresses printing file specs on your terminal, 
as DUMPER saves or restores each file. 

Default: NO FILES 
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FORMAT (VERSION NUMBER IS) n Status-Setting 

Allows DUMPER to read or write tapes written with previous 
versions of DUMPER. 

Default: Version 4 


HELP Action 

Prints a list of all valid DUMPER commands on your terminal. 


[NO] INDUSTRY (COMPATIBLE 36-BIT MODE) Status-Setting 

Allows or does not allow DUMPER to read and write tapes using the 
Industry-Compatible tape data mode. 

Default: CORE-DUMP MODE 


INITIAL (FILESPEC) file spec 


Status-Setting 


Begins a CHECK, SAVE, or RESTORE with the specified file. 


[NO] INTERCHANGE (FORMAT) Status-Setting 

Allows or does not allow DUMPER to read tapes written with the 
TOPS-IO BACKUP program or to write tapes to be read by the 
TOPS-IO BACKUP program. (INTERCHANGE should never be used when 
writing tapes to be read by another TOPS-20 system.) 

Default: DUMPER format 


[NO] LIST (LOG INFORMATION ON FILE) file spec Status-Setting 

Prints or does not print a list, in the specified file, of all 
files as DUMPER saves them. 

Default: NO LIST 

Default file spec: LPT: DUMPER. LOG 


MBEFORE (DATE AND TIME) date time Status-Setting 

Transfers only files modified (changed, created, appended, or 
renamed as maintained by .FBCRE) before the specified date and 
time . 

Default: Time=00 : 00: 01 


MSINCE (DATE AND TIME) date time Status-Setting 

Transfers only files modified (as maintained by .FBCRE) since the 
specified date and time. 

Default : Time=00 : 00 : 01 


PARITY (OF MAGNETIC TAPE) parity 

Sets the parity of the mounted 
Default: The parity listed in 
(ABOUT) TAPE-PARAMETERS 


Status-Setting 

tape to EVEN or ODD. 

the TOPS-20 command INFORMATION 


7-53 



THE DUMPER PROGRAM 


PRINT (DIRECTORY OF TAPE ONTO FILE) destination Action 

Records a printed list of filenames into the specified file. The 
list contains file specs of all existing files on the entire tape 
beginning at the current saveset. 

Default: Prints on your terminal 


PROTECTION (OF RESTORED FILES FROM) argument Status-Setting 

Restores files with SYSTEM-DEFAULT protection or protection taken 
from TAPE. 

Default: TAPE (if the PROTECTION command is omitted) 

Argument Default: None; you must specify one or the other. 


QUIT Action 

Exits to TOPS-20 command level. (Refer to the EXIT command.) 


RESTORE (TAPE FILES) source (TO) destination Action 

Restores the magnetic tape source file(s) to disk with the given 
destination file specs. If you are restoring files from a 
directory other than your connected directory, you must specify 
that directory in the source file specification. If files exist 
in the destination directory with the same names and types as the 
files on tape, DUMPER restores the files according to the 
specification of the SUPERSEDE command: ALWAYS, NEVER, OLDER 
Default: Source file spec = all files in the current saveset 

that were saved under the connected structure and directory; if 
privileged, all files in all directories on your connected 
structure. 

Destination file spec = same names and types as the files on 
tape . 

(Privileged User Only): 

The FDB of each file contains information that reflects whether a 
file is archived or migrated, and, if so, the volume identifiers 
of the DUMPER tapes that contain the file. The /TAPE-INFORMATION 
switch instructs DUMPER to restore this information to the FDBs 
of the files that are being restored. /NOTAPE-INFORMATION 
requests that this information not be restored. 

Default: /TAPE-INFORMATION 


RETRIEVE (FILES) file spec Action 

Instructs DUMPER to process the requests in the system's file 
retrieval queue. 

Default: Process all files in the queue 

(Privileged User Only) 


REWIND argument Tape-Positioning 

Positions the specified tape at the beginning of the tape. If 
the argument is CURRENT-VOLUME, DUMPER rewinds the currently 
mounted tape to the beginning. If the argument is SWITCHING (TO 
VOLUME NUMBER) n, DUMPER releases the currently mounted tape, 
requests volume n of the multi-reel tape set, and rewinds it to 
the beginning. 

Def aul t : CURRENT-VOLUME 
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SAVE (DISK FILES) source (AS) destination 


Action 


Saves the disk source file(s) onto magnetic tape. If all files 
cannot fit on one tape, DUMPER requests that the next volume in 
the set be mounted. 

Default: Source file spec = all files in your connected 
directory; if privileged, all files in all directories on your 
connected structure . 

Destination file spec = same names and types as the files on 
disk . 


(Privileged User Only) : 

The following switches can be appended to the SAVE command: 

/FULL-INCREMENTAL for a system backup of all files. (This 
also marks all files as having been saved.) 


/INCREMENTAL: n for a daily backup of files that either have 
not been saved on at least n tapes, or have been modified 
since the last INCREMENTAL or FULL-INCREMENTAL run. 

Default: /INCREMENTAL: 1 


/NOINCREMENTAL for a backup of all files. 

/ARCHIVE for archival of marked files only. 

/MIGRATE for involuntary migration of marked files only. 
Default: /NOINCREMENTAL 


SET BLOCKING-FACTOR (TO) n (RECORDS) Status-Setting 

Sets the number of logical records per physical record written on 
tape by DUMPER. The range must be between 1 and 15. 

Default: 1 record 


SET TAPE-NUMBER (DECIMAL NUMBER) n Status-Setting 

Assigns a number to a new tape when you continue a restore or 
save after a crash, or when you restore a file nonsequentially 
from a multi-reel saveset. 


[NO] SILENCE Status-Setting 

Activates or suppresses the printing of directory names and file 
specs on your terminal, as files are saved or restored. NO 
SILENCE is equivalent to FILES and DIRECTORIES. 

Default: NO FILES, DIRECTORIES 


SINCE (DATE AND TIME) date time Status-Setting 

Transfers only files created or whose contents were changed since 
the specified date and time. 

Default: Time = 00:00:01 
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SKIP (NUMBER OF SAVESETS) n Tape-Positioning 

Skips over n savesets. The skip can be directed forward (n) , 
backwards (-n) , or to the beginning of the current saveset (0) . 


SSNAME name Status-Setting 

Specifies the name to be written in the saveset header on the 
tape. The name can be any string of up to 30 characters. It is 
printed on your terminal whenever you save or restore files. 
Default: Existing saveset name, if any. 


SUPERSEDE condition Status-Setting 

Sets the condition under which DUMPER rewrites a disk file with a 

magnetic tape file of the same name and file type. You must 

specify one of three conditions: 

1. ALWAYS - to supersede the file on disk regardless of the last 
write date or generation number of that file. 

2. NEVER - to never supersede the disk file? the specified file 
is written to disk only if there is no existing disk file 
with the same name and file type. 

3. OLDER - to supersede the disk file only when the file on tape 
is newer (i.e., has a later write date and/or a higher 
generation number than the file on disk) . 

Default: SUPERSEDE OLDER (if the SUPERSEDE command is omitted) 


TAPE (DEVICE) name: Status-Setting 

Specifies the tape device to be used for file transfers. The 
name can be either a physical device ( MT1 : ) or a logical name 
( TAPEl : ) . 


NOTE 

If you define the mounted tape as 
MTA-DUMPER : , you can omit the DUMPER 
command TAPE. 


UNLOAD 

Used to rewind a tape onto the source reel if your installation 
does not have tape drive allocation enabled. 


7-56 



THE DUMPER PROGRAM 


7.8 DUMPER MESSAGES 


This section contains an alphabetical listing of all messages 
generated by DUMPER. Included with each message are a description and 
a suggested user response. There is also identification of messages 
that appear to privileged users only. The messages printed by DUMPER 
fall into two general categories: warning messages and fatal errors. 
Warning messages are preceded by a percent sign (%) and indicate that 
something unexpected occurred, but that DUMPER was able to recover. 
In this case, verify that the process in progress at the time of the 
warning is correct. Fatal errors are preceded by a question mark (?) , 
and indicate an occurrence that DUMPER could not handle. In this 
case, DUMPER aborts the operation. You must fix the problem before 
reissuing your command string. The % and ? preceding the messages 
are easily detected in Batch jobs. 

Some of the messages contain information that is dependent on the 
exact command string or file you specified. These message variables 
are as follows: 

[device] A device name. 

[<dir>] The name of a directory that could not be created. 

[ file] A file spec . 

[location] The FDB entry that is different in a tape or disk 
file from the corresponding file on disk or tape. 

[n] The number of a page or record. 

[reason] The reason for a file access failure. 

[result] The result of a magtape data error. 

[volid] The identification number of a tape reel. 

PAmbiguous 

Description: You typed a command that requires an argument (such 

as CHECKSUM) but omitted the argument. 

Suggested User Response: Retype the command including the 

appropriate argument. If you do not know what the choices for 
the argument are, type the command followed by a ? . 

%ARCF failure. Invalid function 

Description: (Privileged User Only) You tried to use the RESTORE 

command with an archived file, or for some other reason, DUMPER 
is not able to transfer the contents of the FDB to the disk file. 

Suggested User Response: Reexecute the operation using the 

RETRIEVE command. 

PATTEMPT TO CREATE DIRECTORIES FROM A TENEX TAPE 

Description: You specified the CREATE command for a restore, but 

the tape is in an old format. 

Suggested User Response: Build any directories that you need by 
hand. Do not specify CREATE for the restore. 
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?BAD RESTART FILE. MARK THIS TAPE AS FULL AND USE NEW TAPE 
FOR FURTHER ARCHIVALS. 

Description: (Privileged User Only) You used a restart file 

during archivals that could not be opened. 

Suggested User Response: Build any directories that you need by 
hand. Do not specify CREATE for the restore. 

?BAD VOLUME IDENTIFIER 

Description: You typed an unidentified volid with /VOLIDS:. 

Suggested User Response: Retype or ensure that your volid will 
be acknowledged by the operator. 

%BEGINNING OF TAPE ENCOUNTERED 

Description: During a SKIP-n command, DUMPER reached the 

beginning of the tape before it skipped the specified number of 
savesets. 

? BLOCKING-FACTOR too high for current tape density 
%Tape will be written with BLOCKING-FACTOR of [n] 

Description: Records become too long if you use the specified 

blocking factor. DUMPER sets the BLOCKING-FACTOR to a decimal 
number that the tape can accomodate (between 1 and 15) . 

Suggested User Response: Specify a smaller blocking factor. 

?Blocking factor must be greater than 0 

Description: You specified a blocking factor that was not 1 or 

greater . 

Suggested User Response: Reissue the command specifying a 

positive blocking factor. 

?Cannot backspace on labeled tape 

Description: You attempted to skip backwards on a labeled tape. 

Suggested User Response: Do a REWIND SWITCHING 1, then skip 
forward to the desired saveset. 

7CANN0T CLOSE LOG FILE [file] 

Description: The close of the specified log file failed at the 

end of a save operation. DUMPER stopped logging to the file. 

Suggested User Response: First, exit from DUMPER. Then, give 
the INFORMATION FILE-STATUS command to find the file and give the 
CLOSE command. Then, CONTINUE and give the LIST command again. 

? CANNOT CREATE RESTART FILE 

Description: DUMPER could not open the restart file during an 

archiving run. 

Suggested User Response: Try the operation again. If the error 
persists, contact your Software Specialist or send a Software 
Performance Report (SPR) to DIGITAL. 
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%Cannot find all the pages of file [file], not dumped 
because : 

Description: The number of pages found in the specified file is 

less than the count indicated by the FDB . 

Suggested User Response: None. To prevent this in the future, 
do an EXPUNGE of the directory with a PURGE subcommand to 
recompute the count in the FDB, 

7CANN0T CONTINUE 

Description: You typed CTRL/E to halt the execution of RESTORE, 

CHECK, RETRIEVE, SAVE, or any Tape-Positioning command. You then 
typed a command other than DIRECTORIES, FILES, HELP, or SILENCE 
(preventing DUMPER from being able to continue with the halted 
operation) followed by CONTINUE. 

Suggested User Response: Rewind the tape with the REWIND command 
and repeat the original command. 

%Cannot get JFN for file [file] because: 

[reason] 

Description: You do not have access to the specified file for a 

transfer, check, etc., because there is not enough space on the 
disk to open the file. 

Suggested User Response: First determine whether your own 
directory is full, or other users' directories on the system are 
full. TO do this, type the INFORMATION (ABOUT) DISK-USAGE (OF 
DIRECTORY) dev : <d ir ec tory > . If your own directory is full, you 
must delete and expunge files. If other users' directories are 
full, you must wait until space is cleared. 

%Cannot load file [file] because: 

[reason] 

Description: DUMPER could not load the specified file from tape 

onto the disk area. The reason is specified. 

Suggested User Response: Fix the reason specified for the error 
and try the operation again. 

?Cannot open file [file] because: 

[reason] 

Description: There is an OPENF failure for the file. The reason 

is specified. 

Suggested User Response: If you have wheel or operator 

capabilities, enable them and try the operation again. If you do 
not have these capabilities, omit the operation, 

?Cannot read labeled tapes in BYPASS mode 

Description: You attempted to read a labeled tape while 

bypassing tape labeling. 

Suggested User Response: Remount the tape, but do not specify 
/LABEL: BYPASS in the MOUNT command. 
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?Cannot suppress tape information for a retrieval 

Description: (Privileged User Only) You attempted to retrieve 

files from ARCHIVE or MIGRATION tapes without their tape 
information . 

Suggested User Response: Do not use /NOTAPE-INFORMATION in the 
RESTORE command. 

?Cannot switch to next tape volume because: 

[reason] 

Description: Your attempt to switch volumes for a labeled tape 

failed . 

Suggested User Response: Clear up the problem specified in 

[reason] and try again. 

?Carriage return required. 

Description: You typed a comma, indicating more than one file, 

and then ended the string with a nonalphanumer ic character other 
than a carriage return. 

Suggested User Response: Retype the string without the comma and 
extraneous file specs, if any. Terminate the string by pressing 
RETURN. 

?Checksum error, record [n] 

Description: The checksum is wrong for the specified record 

number although there is no data error. 

Suggested User Response: Verify that the files you are trying to 
save or restore are correct. If not, save them again or restore 
them from another tape. 

%Compare error, page [n] , file [file] 

Description: There is a file in which the data on tape differs 

from the data on disk. This message is printed only if the CHECK 
command has been typed. The n indicates the page number of the 
file on disk, and file spec is the file in which the error 
occur s . 

Suggested User Response: Try to transfer the file again. Note, 
however, that this error is often caused by a program that 
updated the file after you saved it on tape. 

?Device error, possible incorrect density. 

Type <CR> to try again. 

Description: You typed the PRINT, RESTORE, SKIP, EOT, or CHECK 

command to DUMPER when: 

® There was nothing written on tape, 

© You were using INTERCHANGE when the tape was not 
interchange, or vice versa. 

© The tape density was incorrect, or 

© The tape was on a faulty drive. 


7-60 



THE DUMPER PROGRAM 


Suggested User Response: Type CTRL/E and try another command , 
exit from DUMPER and mount another tape, or check and respecify 
the density. 

?DEVICE MUST BE DISK 

Description: You attempted to save files from a non-disk device. 

Suggested User Response: Use only disk devices. 

%Difference in [location] of file [file] 

Description: There is a difference in the indicated FDB location 

between the file on disk and the file on tape. The FDB contains 
information describing the history and structure of the file. 
Refer to Table 7-3 for common locations and the meaning when 
there is a difference. 

Suggested User Response: Try to transfer the file again. If the 
error still occurs, contact the operator or system manager. 

%Directory [<dir>] not created because, [reason] 

Description: A directory could not be created to hold the files 

to be transferred. The reason is specified. 

Suggested User Response: Create the directory with the BUILD 
command and try again. Or, restore the files to a different, 
existing directory. 

?DISK ERROR IN FILE [file] , PAGE [n] 

Description: A disk file data error occurred on the specified 

page. The file is bad. 

Suggested User Response: To stop this error, correct the bad 

file by copying it over itself or re-creating it. 

%DISK ERROR IN FILE [file], PAGE TABLE 

Description: A data error occurred in the index block for the 
file. The file is bad. 

Suggested User Response: To stop this error, correct the bad 

file by copying it over itself or re-creating it. 

?Disk full or guota exceeded, Type <CR> to attempt to continue 

Description: There is no disk space available in your area to 
restore the file(s). 

Suggested User Response: If you are still unable to continue 

after typing RETURN, type CTRL/C to exit to TOPS-20 command 

level. Delete and expunge all unnecessary files. Then type 
CONTINUE to return to DUMPER, and try typing RETURN again. 
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%Do you really want to abort your interrupted command? 

Description: You typed CTRL/E, followed by a DUMPER command 
other than a Status-Setting command. 

Suggested User Response: You must respond with either Y (yes) or 
N (no). If you type any other response, DUMPER prints ?YES or NO 
only. If you type N, you can then type CONTINUE and the 
interrupted command continues. If you type Y, the current 
command process is halted, and you can enter a new command in 
response to the DUMPER prompt. 

?Does not match switch or keyword 

Description: You typed an unrecognized argument with a command 

that takes either an optional or mandatory argument (for example, 
ACCOUNT) . 

Suggested User Response: Retype the command, including an 
appropriate argument. If you do not know which arguments are 
acceptable for this command, type the command, followed by a 
space and a question mark. 

?Drive probably off-line, type <CR> when ready to try again. 
Description: One of two problems exists: 

1. The operator has not placed the tape drive on line. 

2. You are attempting to read the tape at the wrong density. 


Suggested User Response: Make sure the operator has the tape on 
line. Or type a CTRL/C, restart DUMPER, and reset the density 
with the DENSITY (OF MAGTAPE) command. 


NOTE 

If you cannot recall the correct 
density, try each one: 200-BPI, 
556-BPI, 800-BPI, 1600-BPI, and 
6250-BPI . 


%Duplicate record encountered, record [n] ignored. 

Description: Each record on tape has a sequence number. When 
DUMPER reads a record, it checks to see if the sequence number is 
one greater than the previous record. DUMPER prints the above 
message if the sequence number is the same as the previous 
record. The sequence number is the same, because a record error 
was encountered when the tape was originally written. For each 
error encountered, DUMPER created a duplicate record (refer to 
the message %WRITE ERROR ON TAPE, RECORD n, WRITING DUPLICATE 
RECORD) . When you restore the files from that tape, DUMPER reads 
the bad record first. Since normal reading operates at a greater 
fault tolerance than write-checking, DUMPER may be able to read a 
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record that was previously thought to be bad. If this occurs, 
DUMPER takes the first record and ignores the duplicate (second) 
record. If the first record is bad, DUMPER prints either 
? MAGTAPE DATA ERROR, ? MAGTAPE UNKNOWN ERROR, ? MAGTAPE CHECKSUM 
ERROR, or another similar message. DUMPER then reads the next 
record. If the duplicate record is correct, DUMPER prints the 
message RECOVERED. If the error is not recovered, DUMPER prints 
a message indicating the location of the bad record and continues 
the transfer. 

Suggested User Response: Ignore this warning message. 

%End of tape encountered 

Description: You typed EOT or SKIP n, and the tape advanced to 

the end-of-tape marker. 

Suggested User Response: Type REWIND or SKIP -n to return to the 
beginning of the tape, or to a previous saveset. 

?End of tape, mount next reel 

Description: (Privileged User Only) You accessed a tapeset and 

the currently-mounted reel is finished. DUMPER prompts you to 
mount the next volume of the set. 

Suggested User Response: Mount the next volume. 

%End of tape reached and requested file not found 

Description: You attempted to locate a file that does not exist 

on the currently-mounted tape. 

Suggested User Response: Try another tape on which the file 
might have been saved. 

?ERROR POSITIONING TAPE: 

Description: Your backspace operation failed on a labeled tape. 

Suggested User Response: Try the operation again. If it still 
fails, contact your Software Specialist or send a Software 
Performance Report (SPR) to DIGITAL. 

?Error rewinding tape, 

[reason] 

Description: DUMPER failed to rewind the current tape for the 

specified reason. 

Suggested User Response: Fix the reason for the failure and try 
again . 

?Error switching volumes 

Description: A volume switch failed on a labeled tape. 

Suggested User Response: Fix the reason for the failure and try 
again . 
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%FAILED IN ATTEMPT TO DELETE RESTART FILE 

Description: DUMPER could not find the restart file while trying 

to delete it during an archive run. 

Suggested User Response: Exit from DUMPER and delete the file by 
hand . 

PFAILED TO FIND MAGTAPE , 

[reason] 

Description: DUMPER cannot open the magtape for the specified 

reason. 

Suggested User Response: Fix the problem specified by [reason] 
and try again. 

?FAILED TO MOUNT MTA , Device already assigned to another job 

Description: You used the TAPE command to specify a device that 

is not assigned to you. 

Suggested user Response: Specify another device. 

7FAILED TO OPEN MAGTAPE 
7DEVICE IS NOT ON-LINE 
TRY AGAIN? 

Description: The tape you are trying to access is not on line. 

Suggested User Response: Type Y(yes) if you want to try again or 
N(no) if you do not. If you have further questions, contact the 
operator . 

%Failed to restore [file] 

was not retrieved because: [reason] 

Description: You requested that a file be retrieved from an 
ARCHIVE or MIGRATE tape. The operator was not able to restore 
the file for the reason specified. 

Suggested User Response: Fix the problem specified by [reason] 
and try again. 

%File author differs for file [file] 

Description: A CHECK command found a file whose author differs 

from that stored on tape. 

%File [file] continued from previous reel has missing page(s) 

Description: The reel was changed in the middle of saving a 

file. In attempting to do a restore, you discovered that page 
numbers are missing or they do not match. 

Suggested User Response: Restore the file from another tape. 
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%File [file] continued on next reel 

Description: You attempted to access a file that is split 

between two tapes. This message informs you that the remainder 
of the file is on the next reel. DUMPER performs a EWIND 
SWITCHING to the next volume. 

Suggested User Response: Ignore this message 

?File [file] deleted while superseding 

Description: The disk file has a higher generation number than 

the tape file that replaces it. The disk file is deleted. 

?File [file] has page(s) missing 

Description: You attempted to restore a file, and the number of 

pages restored did not match the number of pages indicated by the 
FDB . 

Suggested User Response: Verify that all pages were restored. 

%File last-writer differs for file [file] 

Description: A CHECK command found that the last writer of the 

specified file differs from that on tape. 

?File [file] not dumped because: 

[reason] 

Description: The file was not written to tape for the reason 
spec i f ied . 

Suggested User Response: Fix the problem specified by [reason] 
and try the SAVE again. 

%File not found - [file] 

%No files dumped 

Description: You attempted to save a nonexistent file. 

Suggested User Response: Retype the file spec or check your 
directory to make sure the file has not been deleted or renamed. 

%File trailer missing for file [file] 

Description: The record following the data records is missing 
for the specified file on tape. 

%Files being restored without tape information 

Description: You are restoring files from an ARCHIVE tape. 

Suggested User Response: Use RETRIEVE to restore the files. 

?First nonspace character not a digit 

Description: You attempted to SET BLOCKING-FACTOR to a 

specification other than a digit. 

Suggested User Response: Retype the command using a decimal 
number . 
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%Invalid account for file [file], 
system default used 

Description: You attempted to restore a file in which the 

account number on tape is different from your account on disk. 

Suggested User Response: The message is only a reminder, and no 
action is necessary. The file is restored. Use the ACCOUNT 
SYSTEM-DEFAULT command to suppress this. 

? INVALID DATE AND TIME 

Description: You entered the date or time in an incorrect 

format . 

Suggested User Response: Enter the date in any standard American 
or European format. Enter the time in hh:mm am/pm format or in 
24-hour format. 

? INVALID FILE GROUP DESCRIPTOR 

Description: DUMPER failed to get a JFN when it needed to 

default the destination file spec. 

Suggested User Response: Try the operation again. 


? INVALID FILESPEC, No such file type 

Description: You typed an invalid filename with the INITIAL 

command . 

Suggested User Response: Check the files on tape or directory 
and make sure none has been deleted. Retype the command with the 
correct filename. 

?Invalid magtape designator, [reason] 

Description: You specified an invalid device name with the TAPE 

command to DUMPER. 

Suggested User Response: Retype the command using the 

appropriate device or logical name, or return to TOPS-20 command 
level to MOUNT a tape or ASSIGN a tape to your job. 


NOTE 

If you define the logical name 
MTA-DUMPER : as a magnetic tape device 
name (such as MTA2 : ) , you do not need to 
type the TAPE command after entering 
DUMPER. 


? INVALID NUMBER 

Description: You specified an invalid number of tapes with the 

SAVE/INCREMENTAL command. 

Suggested User Response: Specify a valid number. 
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7INVALID TIME FORMAT 

Description: You used one of the BEFORE or SINCE Status-Setting 

commands without an appropriate time format (for example, 
30-May-79am) . 

Suggested User Response: Retype the command using any acceptable 
format or no time at all (default = 00:00:01). 

? JSYS ERROR: STRUCTURE IS NOT MOUNTED 

Description: You tried to do a transfer to or from a structure 

that is not mounted. 

Suggested User Response: Respecify a mounted structure or exit 
to TOPS-20 and mount the desired structure. 

PLabeled tapes can be switched only to volume 1 

Description: You specified a volume number other than 1 with 

REWIND SWITCHING, using a labeled tape. 

Suggested User Response: Rewind to the first volume of the tape 
se t . 

PLabeled tapes must be MOUNTed 

Description: You attempted to use the TOPS-20 command ASSIGN to 

mount a labeled tape. 

Suggested User Response: Use the TOPS-20 command MOUNT TAPE 
name : . 

%Log file not available, [file] 

Description: DUMPER cannot open the specified log file. 

Suggested User Response: Use another file. 

7MAGTAPE data error record [n] 

Description: DUMPER encountered a data error while reading the 

magtape. 

Suggested User Response: Verify that the affected file is 

correct. 

? MAGTAPE record length error record [n] [result] 

Description: While reading the magtape, DUMPER read a record 

with an incorrect length. 

Suggested User Response: Verify that the affected file is 

correct. 

? MAGTAPE unknown error record [n] [result] 

Description: A read failed for the magtape, but the monitor did 

not return any error bits. 

Suggested User Response: Verify that the file is correct. If 
the error persists, contact your Software Specialist or send a 
Software Performance Report (SPR) to DIGITAL. 
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%No in ter r uptable command in progress 

Description: You typed CTRL/E when no command action was in 

progress (for example, in response to DUMPER> or a request such 
as $TAPE file spec) . 

Suggested User Response: Press RETURN. DUMPER responds with its 
prompt or with the last request typed. 


%No such device - [device] 

Description: You typed an unassigned device name with the TAPE 

command and then attempted to do a transfer. 


Suggested User Response: Retype TAPE, including the correct 

device or logical name. Then retype the transfer command. 

%No such file type - [file] 


Description: You typed an invalid filename 
command . 

Suggested User Response: Check the directory to 
desired file has not been deleted or renamed, 
command specifying the correct filename. 


with the SAVE 

make sure the 
Retype the SAVE 


?N0 TAPE DEVICE SPECIFIED YET 

Description: You gave the UNLOAD command without specifying a 

tape . 

Suggested User Response: Use the TAPE command to first specify a 
tape . 

?NOT A DECIMAL NUMBER 

Description: You specified something other than a decimal number 

with DENSITY, SET TAPE-NUMBER, SET BLOCKING-FACTOR, SKIP, or 
REWIND SWITCHING. 

Suggested User Response: Retype the command using an appropriate 
decimal number. 

?NOT A DEFINED COMMAND 

Description: You mistyped a command or tried to use a command 

that does not exist in DUMPER. 

Suggested User Response: Enter a valid DUMPER command. 

?NOT A SWITCH OR FILESPEC, [error] 

Description: You typed incorrect data at a point where DUMPER 

required a switch or a file spec. 

Suggested User Response: The reason specified by [error] 

describes the problem. Retype the correct command. 
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?NOT CONFIRMED 

Description: You typed an argument with a command that does not 

take an argument. 

Suggested User Response: Retype the command with no argument. 

?Not enough monitor table space for current BLOCKING-FACTOR 

Description: You specified a record that was larger than the 

available buffer space in the monitor. 

Suggested User Response: Use a smaller BLOCKING-FACTOR value. 
PCarriage return required 

Only one filespec allowed for archival or migration runs 

Description: (Privileged User Only) You typed more than one file 

spec in a SAVE command using /ARCHIVE or /MIGRATE. 

Suggested User Response: Type only one file spec when you use 
these switches. 


70UTPUT FILESPEC INVALID , Invalid wildcard designator 


Description: You included an invalid wildcard in a file spec, or 

specified a wildcard where it is not appropriate. 

Suggested User Response: Retype the [file] with an acceptable 
wildcard or no wildcard. 

%Partial file [file] skipped 

Description: At the beginning of a tape, DUMPER found a file 

that continued from a previous tape. 

?PDL overflow trap in DUMPER 
?PC= [ n ] 

Description: A stack overflow trap occurred at the specified PC. 


Suggested User Response: This is not expected to happen. If it 
does, contact your Software Specialist or send a Software 
Performance Report (SPR) to DIGITAL. 


%Please mount tape [volid] 

Description: (Privileged User Only) It is necessary to mount the 
specified tape volume in order to RETRIEVE a requested archived 
or migrated file. 


Suggested User Response: Locate the appropriate reel and mount 
it. 


%Retrieve aborted 

Description: (Privileged User Only) You did not find the 

requested file on either set of ARCHIVE or MIGRATE tapes 


Suggested User Response: Inform the requestor, 
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? RETRIEVE requires WHEEL or OPERATOR capabilities enabled 

Description: You attempted to use the RETRIEVE command when you 

do not have WHEEL or OPERATOR capabilities enabled. 

Suggested User Response: Enable these capabilities or do not use 
RETRIEVE. If you do not have WHEEL or OPERATOR privileges, you 
might have intended to use RESTORE. 

PSequence error, record [n] , continuing. 

Description: During a restore, DUMPER encountered a record 

sequence number that is not one greater than the previous record. 
DUMPER resets the internal sequence counter to the new number, 
and continues with the current operation. If the sequence number 
is irregular, you may receive a second message when the numbers 
regain their previous value. 

Suggested User Response: Carefully check the file being restored 
at the time the message was issued. If the file contains errors, 
you should attempt to restore the file from the backup copy of 
the tape. 

%Structure not mounted, skipping file [file] 

Description: (Privileged User Only) You attempted to retrieve a 

file that was archived or migrated as a structure not currently 
mounted . 

Suggested User Response: Requeue the request and process the 
next one. Mount the appropriate structure so that DUMPER can 
locate the file when the request is processed again. 

PSwitch combination invalid 

Description: You specified an incremental switch with /ARCHIVE 

or /MIGRATE. The incremental switches can be used only with 
SAVE. /ARCHIVE and /MIGRATE cannot be used with an incremental 
switch. 

Suggested User Response: If you are archiving or migrating 
files, do not use any form of /INCREMENTAL. If you wish to do an 
incremental save, use SAVE followed by an incremental switch. 

?Tape count must be greater than 0 

Description: (Privileged User Only) You specified a 0 or 

negative number with /INCREMENTAL: n. 

Suggested User Response: Retype the command using a positive 
decimal number. 

%Tape does not start with header, continuing... 

Description: You did not position the tape at the beginning of 

the saveset before doing a RESTORE. 

Suggested User Response: Type CTRL/E. DUMPER responds with 

Interrupting... and its prompt. Type REWIND, and then type 
RESTORE. 


7-70 



THE DUMPER PROGRAM 


?Tape error prevents proper positioning of tape for new saveset 
$Mark this tape as full. 

Description: When you tried to append archival or migration data 

to an old tape, DUMPER could not find the proper tape location. 

Suggested User Response: Start with a new tape and mark this one 
as full. 

?TAPE FULL. PLEASE MARK IT. 

Description: DUMPER reached the end of the tape during an 

ARCHIVAL or RETRIEVAL operation. 

Suggested User Response: Mark the tape as full, and continue 
with a new tape. 

%Tape has file(s) missing 

Description: While DUMPER was reading a tape, the file seguence 

number did not increment as expected. 

Suggested User Response: Verify that there are no missing files 
on the tape. 

%Tape is format version [n] , not current 

Description: You attempted to read or write a tape that was 

written with an earlier than the current version of DUMPER. 

Suggested User Response: Use the FORMAT (VERSION NUMBER IS) n 
command to specify which version the tape was written in. 

%Tape is write protected, Type <CR> when ready to try again 

Description: You attempted to write to a tape without a write 

ring in the back. 

Suggested User Response: Remount the tape and specify that the 
tape is to be write-enabled. 

%Tape may be wrong format 

Description: There is a read data error at the beginning of the 
tape. The tape may have been written in INTERCHANGE format. 

Suggested User Response: Rewind the tape and use the INTERCHANGE 
command. If this is not successful, mount another tape. 

Tape specification needed, 

$Tape filespec 

Description: You tried to access a magnetic tape, but did not 

type the TAPE command. DUMPER postpones the command you used and 

tries to use the logical name, MTA-DUMPER: . That name, however, 
was not defined with a TOPS-20 ASSIGN, TMOUNT , or DEFINE command. 

Suggested User Response: Type the name of the magnetic tape 
drive you are using, followed by RETURN, or return to TOPS-20 
command level and define the logical name MTA-DUMPER:. 
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%Tapes not in order, cannot restore continued file [file] 

Mount correct tape and type CONTINUE 

Description: You attempted to restore a file continued on 

another tape. The next tape mounted does not contain the 
continued file. 


Suggested User Response: Locate and mount the 

%TAPES NOT IN ORDER, continuing 

Description: During scanning or skipping, the 

encountered. The next tape is not the correct 

Suggested User Response: Locate and mount the 

?This tape has been previously used for a different 


correct tape. 

end of the tape is 
one in sequence. 

correct tape. 

DUMPER purpose. 


Description: You attempted to migrate, archive, or backup files 
onto a tape that was previously used for a function other than 
the one you specified. 


Suggested User Response: Use a new tape, or a tape already used 
for the same function as the one you are currently performing. 


?TOO MANY ITEMS IN FILESPEC LIST 


Description: You typed too many file specs for DUMPER to store 

in its tables. 

Suggested User Response: Use fewer file specs in your SAVE 
command. If necessary, split up the files into groups and make 
several savesets. 

?Unable to clear archive/migration request bit after migration to tape 
complete . 

Description: (Privileged User Only) After you saved a file on 

tape for migration or archiving, the ARCF JSYS failed to clear 
the archive status. 

Suggested User Response: Contact your Software Specialist or 
send a Software Performance Report (SPR) to DIGITAL. 


PUNABLE TO SET DENSITY, JOB DEFAULT USED 

Description: DUMPER was not able to set the density of the tape 

to your specification. Therefore, it uses the default of the 
current job. 

Suggested User Response: Accept the selected default, or pick a 
density that is allowed. 

% UNABLE TO SET TAPE DATA MODE, JOB DEFAULT USED 

Description: You attempted to set the tape data mode to the 

INDUSTRY-COMPATIBLE mode of 36-bits. DUMPER is not able to set 
your tape, and reverts to CORE-DUMP mode. 
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?Unexpected error reading tape 

Description: A read failed for a magtape. There was no known 

error code returned by the monitor. 

Suggested User Response: Try the operation again. If the error 
persists, contact your Software Specialist or send a Software 
Performance Report (SPR) to DIGITAL. 

?Unexpected memory execute trap in DUMPER 
?VA= [n] 

?PC= [n] 


Description: A fatal address fetch occurred at the given PC and 

virtual address. 

Suggested User Response: Contact your Software Specialist or 
send a Software Performance Report (SPR) to DIGITAL. 

?Unexpected memory read trap in DUMPER 
?VA= [n] 

?PC= [n] 


Description: A read failure occurred at the given PC and virtual 

address. 

Suggested User Response: Contact your Software Specialist or 
send a Software Performance Report (SPR) to DIGITAL. 

?Unexpected memory write trap in DUMPER 
?VA= [n] 

?PC= [n] 


Description: A write failure occurred at the given PC and 
virtual address. 

Suggested User Response: Contact your Software Specialist or 
send a Software Performance Report (SPR) to DIGITAL. 

%UNRECOGNI Z ED RECORD TYPE ON INTERCHANGE TAPE, RECORD SKIPPED 

Description: DUMPER attempted to read a record of an unknown 

type from an interchange tape. 

Suggested User Response: If this is a tape written under 
TOPS-1 0 , REWIND and use INTERCHANGE. Retype the command that 
produced this message. 

%Use the DISMOUNT TAPE command to unload MOUNTed tapes 

Description: You attempted to use UNLOAD to DUMPER. UNLOAD does 

not work if you mounted a tape using MOUNT to TOPS-20. 

Suggested User Response: Exit from DUMPER and type the TOPS-20 
command DISMOUNT TAPE device name:. 


7-73 



THE DUMPER PROGRAM 


7VOLUME NUMBER MUST BE POSITIVE 


Description: You typed a negative number with REWIND SWITCHING. 


Suggested User response: Retype the command using the number of 
the volume in the tape set. 

? WHEEL or OPERATOR capabilities required 

Description: You attempted to use a DUMPER command (such as 

SAVE/ARCHIVE) to which you do not have access. 


Suggested User Response: If you have WHEEL or 

capabil i ties , return to TOPS-20 and type ENABLE, 
responds with a dollar sign ($) prompt. If you do not 
capabilities, do not use the DUMPER command that 
message . 


OPERATOR 
The system 
have such 
caused the 


%Write error on tape, record [n] , writing duplicate record 


Description: Due to areas on the tape where data cannot be read 
or written, DUMPER encountered an error in the record just saved 
on tape. Therefore, it writes a duplicate record immediately 
following the invalid record, and prints the message above. 

Suggested User Response: If there are many errors, it is wise to 
replace the tape. In some cases, if there are only a few errors, 
the tape is probably dirty. On newer drives, repeated saving 
procedures will clean it and reduce errors. On older drives, use 
a tape cleaning device. 


?Wrong tape mounted, cannot retrieve continued file 

Description: You attempted to restore a file that was split 

between two tapes when saved. You restored the first portion of 
the file and mounted a second tape. The remainder of the file is 
not on this tape. 

Suggested User Response: Locate the appropriate tape, mount it, 
run DUMPER and restore the remainder of the file. 


7WRITE ERROR ON TRAILER RECORD! 

?this [type] tape is valid for the current and all previous runs 
?But, it should NOT be used for any future runs!!! 

? ****** MARK THIS TAPE AS FULL ********* 

Description: A write error occurred while DUMPER was finishing 

an archival or migration run. 

Suggested User Response: Use another tape for future archival or 
migrations. 

?YES or NO only 

Description: You typed something other than Y for yes or N for 

no in response to a question issued by DUMPER. 

Suggested User Response: Respond with Y or N. 
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THE PLEASE PROGRAM 


8.1 INTRODUCTION 

The PLEASE program allows you to communicate with the operator. You 
can use this program to: 

® ask the operator to perform a specific task 

© ask the operator for information concerning your job 

© supply the operator with information regarding your job. 

Commands and switches within the program allow you to vary the type of 
message processing. The operator may reply to the message, depending 
on the command or switch you give. 


8.2 RUNNING PLEASE 

You can give commands to PLEASE at either TOPS-20 command level or at 
PLEASE program command level. At TOPS-20 command level (Section 
8.2.1), you type PLEASE and then type your message preceded by a node 
name and/or any switches. At program command level (Section 8.2.2), 
you type PLEASE and then press the RETURN key. After the prompt, you 
can type your message preceded by a command and a node name and/or 
switch. 


NOTE 

The PLEASE command that you use in a 
batch job does not function like the 
timesharing PLEASE program. For 
information on using the PLEASE command 
in a batch job, refer to the 
TOPS-1 Q/TOPS-2 0 Batch Reference Manual. 


8-1 



THE PLEASE PROGRAM 


8.2.1 Running PLEASE at TOPS-20 Command Level 

To run PLEASE at TOPS-20 command level, type PLEASE after the TOPS-20 
prompt @, type your message text on the same line, and press RETURN. 
In this case, the program assumes that you are waiting for a reply. 
For example: 

© ' P L E A S E W h a 1 y s h o 1 d i n £ u p m y p r i n t J o b (ctruQ ? ( ret ) 

T M e s s a £ e s e n t a t 13*31* A 0 w a :i. t i n £ f o r o p e r a t o r res p o n s e .1 


NOTE 

If you want to include special characters, such as a 
question mark or an ESCAPE, in your message, you must 
precede the character with CTRL/V. 


You can send a message that exceeds one line. To do this, type a 
hyphen (-) after the last word in the first line of your message, and 
press RETURN. Continue your message on the next line and any other 
lines following it, ending each line to be continued with a hyphen. 
To send your message to the operator, press RETURN after the last line 
of your message. 

After you press RETURN, the program outputs the time you sent the 
message and a reminder that you are waiting for the operator to reply. 
You do not receive the TOPS-20 prompt after this notification; the 
program assumes that you are waiting for a response from the operator. 
When you receive the response, you are returned to TOPS-20 command 
level. For example: 

1 3 ♦ 3 1 * 5 5 F r o m o p e r a t o r t e r in i n al 3 ♦ 

~ > H a d t o c h a n £ e r i b b o n ♦ * ♦ y o u r 1 i s t i n £ p r i n t :i. rn £ n o w * 

@ 

The response contains the time that the operator sent the reply. 

You can exit from PLEASE by typing two CTRL/C ' s and still receive the 
operator* s reply. However, your reply from the operator is lost 
unless you do one of the following: 

® Type the CONTINUE command. 

• Type the RESET command. 

® Run another program immediately after you send your PLEASE 
message. 

If there is no operator in attendance, PLEASE informs you and 
immediately returns you to TOPS-20 command level without waiting for a 
response. Your message is queued until an operator is available to 
reply. For example: 

©PLEASE Has my new tape been mounted on MTA 1 ? ( ) 

f- M e s s a £ e s e n t a t 1 0 1 1 0 * ^ 6 there is ri o o p e r a t o r i n a 1 1 e n d a n c e 1 
© 
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When you run PLEASE at TOPS-20 command level, you can include an 
optional node name and/or one or more switches in the command line. 

Node Names 

A node name assures that only operators at a remote node receive 
your message. If an operator is in attendance at the node you 
specify, the message is sent there. Otherwise, the message is 
sent to the central site operator. To send a PLEASE message to a 
node, type PLEASE, the node name followed by two colons, the 
message, and press RETURN. You must leave a space between the 
word PLEASE and the node name. A space is optional between the 
second colon and the beginning of your message. You send a 
message to a node as in the following example: 

@ PLEASE DN2O0:: Cancel mw Batch Job ♦C«D 

I.. M e s s a 3 e s e n t a t 11 123* 3 4 w a i 1 1 n f o r o p e r a t o r r e s p o n s e 3 
Switches 

You can type a switch after the node name in the command line. 
These switches determine the type of message processing. To 
include switches in the command line, include them immediately 
before your message. 

/MESSAGE 

Type /MESSAGE to indicate to the operator that you do not expect 
a reply to your message. For example: 

@ PLEASE /MESSAGE This is only a test ♦Q"D 
C 0 p e r a t o r n o t i f i e d a t 10M6J 3 5 3 
0 

After you press RETURN, PLEASE gives you the time that the 
operator received your message. If you do not specify /MESSAGE 
in the command line, the program assumes that you expect a reply 
from the operator. 

/NOWAIT 

Type /NOWAIT to send a message to the operator and immediately 
return to TOPS-20 command level. You do not wait for a reply to 
your message. When it is convenient for the operator to reply, 
you receive the response. If you do not specify /NOWAIT in the 
command line, the program assumes that you are waiting for a 
reply from the operator and does not return you to TOPS-20 
command level. 

For example, if you wish to send a message to the operator at 
node 4097 and do not wish to wait for the reply, the command line 
looks like the following: 

$ PLEASE 40975: /NOWAIT Any stand-alone time open tomor row(<jj» ) 

CMessade sent at 10 *47: 273 
@ 
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8.2.2 Running PLEASE at Program Command Level 

To run PLEASE at program command level, type PLEASE after the TOPS-20 
prompt @, and press RETURN. The program responds with the prompt as 
follows : 


ePLEASEGID 

PLEA5E> 

This prompt is for you to type a program command, with or without an 
optional node name, a switch, and message text. 

Commands 

There are four commands you can use when you run PLEASE at 
program command level. You use two of them, SEND and MESSAGE, in 
a PLEASE command line to send a message to the operator. You use 
the other two, CANCEL and EXIT, for non-message functions. 

The SEND Command 

Type SEND after the PLEASE prompt to send a message to the 
operator and indicate that you expect a reply to your message. 
The command line can include an optional node name. (Refer to 
Section 8.2.1.) You can also include /NOWAIT to indicate to the 
operator that you are not waiting for the reply to your message? 
you return to program command level after you press RETURN. 
After the command, the optional node name and the optional 
switch, type your message text. Remember to use a hyphen if you 
wish to send a message that exceeds one line. 

The syntax for the SEND command line is as follows: 

©PLEASE® 

PLEASE>SEND CnodeJn C/NOWAIT 1 text ♦ . .GOD 

For example, you wish to send a message to node DN20 and wait for 
the reply: 

ePLEASECUD 

PLEASE>SEND DN20S3 Waiting for answer to tape Question ♦ (/*** ) 

I! Message sent at 10 * 56 1 49 waiting for operator response! 

In this case, you do not receive the PLEASE prompt until the 
operator replies or unless you use /NOWAIT in the command line. 

You have another option with the SEND command. Instead of typing 
your message text on the same line (with an optional node name 
and/or switch) , you can press RETURN before you type the message; 
for example: 


©pleaseCUD 

PLEASE>SEND DN20::C mD 

Enter Text and Terminate with *"Z 

Waiting for an answer to tape Question » C * ET 1 

Do you need more inf ormat ion? ( ret ) 

(CTRL/z) 

C Message sent at 13 ♦ 44 ♦ 39 waiting for operator response! 

Note that in this case, you type CTRL/Z after you complete the 
message . 
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The MESSAGE Command 

Type MESSAGE after the PLEASE prompt to send a message to the 
operator and indicate that you do not expect a reply to your 
message. The command line can include an optional node name. 
When you type the text of your message, remember to use a hyphen 
if the message exceeds one line. 

The syntax for the MESSAGE command line is as follows: 

©PLEASEC 

P L E A S E > M E S S A G E I" n o d e ♦ t "I text* ♦ ♦ ( KET ) 

For example, you wish to send a test message to the operator at 
your installation: 


©PLEASE 

PLEASE MESSAGE This is Just a test ♦ ( RET ) 

II (3 p e r a t o r n o t :i. f i e d a t 1 1 ♦ 0 6 ♦ 3 5 "I 
PLEASE> 

You have another option with the MESSAGE command. Instead of 
typing your message text on the same line (with an optional node 
name), you can press RETURN before you type the message? for 
example : 


©pleaseCUD 

P L E A S E > MESSAGE 21165 jQiD 
Enter Text and Terminate with 

This message sloes to an operator at node 2 116 . C^O 
It is Just- a test ♦ ( «et 3 


C! Ope r a to r not i f led at 145015153 
PLEASE> 

In the case of both the SEND and MESSAGE command lines, the program 
returns with the PLEASE prompt after it processes your message. You 
can type another command line, or one of the following commands: 

The CANCEL Command 

Type CANCEL after the PLEASE prompt to cancel all outstanding 
messages your job has queued for the operator to answer. 

For example, if you send three messages to the operator and then 
wish to cancel all of them: 

e pleaseC«D 

P L E A S E > CANCEL (all out s t a n d i n £ M e s s a .des ) ( ret ) 

II 3 M e s s a <3 e ( s ) C a n e e 1 e d II 
PLEASE> 

The EXIT Command 

Type EXIT to exit from the PLEASE program and return to TOPS-20 
command level. For example: 

©PLEASEQlD 
P LEASE >E X I TC^eT) 

0 
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8.3 PLEASE MESSAGES 

The following is an alphabetical list of the most common PLEASE 
messages. A warning message is preceded by a percent sign (%) . Fatal 
errors are preceded by a question mark (?) . A description is supplied 
for each message, along with a suggested user response where 
appl icable . 

? GLXINI - Unable to obtain run-time system 

Description: You attempted to run PLEASE from a directory that 

does not include GLXLIB.EXE. 

Suggested User Response: Either run PLEASE from a directory that 
includes GLXLIB.EXE or put a copy of it in the directory that 
contains PLEASE . EXE . 

? Invalid PLEASE command specified 

Description: You typed an invalid PLEASE command after the 

program prompt. 

Suggested User Response: Type one of the four valid PLEASE 
commands after the program prompt. 

? Invalid PLEASE switch specified 

Description: You typed an invalid PLEASE switch in the command 

line . 

Suggested User Response: Type one of the two valid PLEASE 
switches in the command line. 

[Message sent at [time]] (waiting for operator response) 

or 

(there is no operator in attendance) 

Description: PLEASE sent your message to the operator at the 

specified time. If you asked to wait for a response and the 
operator is in attendance, PLEASE types the first option. If 
there is no operator in attendance, PLEASE types the second 
option . 

% Message truncated - text exceeded buffer capacity 

Description: You typed a message longer than PLEASE can handle. 

Suggested User Response: Type only messages that are 2,000 
characters or less. 

[Operator notified at [time]] 

Description: PLEASE sent your message to the operator at the 

specified time. You did not request a response, so PLEASE does 
not wait for one. 
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? There are no outstanding messages for this program 

Description: You attempted to cancel all of your queued messages 

to the operator and there were none outstanding. 

? Unrecognized response from ORION 

Description: PLEASE received a message from ORION, the operator 

interface, that it could not understand. Your installation may 
be running an old version of PLEASE. 

Suggested User Response: Contact your Software Specialist or 
send a Software Performance Report (SPR) to DIGITAL. 


8-7 










INDEX 


/A switch, 

CREF, 5-4 
FILCOM, 4-3, 4-11 
ABEFORE command, 

DUMPER, 7-8, 7-51 
Absolute break, 6-4 
ACCOUNT command, 

DUMPER, 7-8, 7-14, 7-51 
Action commands, 

DUMPER, 7-7, 7-23, 7-24 
Activating an edit, 6-23 
Active edit, 6-20 
ALGOL compiler source files, 
5-1 

ALGOL CREF listinq example, 
5-9 

/ALL switch, 

RDMAIL , 3-4, 3-5 
Allocation , 

status of tape drive, 7-3 
Tape drive, 7-3 
.ALTER pseudo-op, 6-21 
/APPEND switch, 

MAKLIB, 6-7, 6-27 
/APPEND switch example, 
MAKLIB, 6-9 
/APPEND switch figure, 
MAKLIB, 6-8 
Appending modules to 
libraries, 6-7 
ARCHIVE command, 7-31 
/ARCHIVE switch, 

DUMPER, 7-43, 7-48, 7-55 
Archived and migrated files, 
Restoring, 7-50 
Retrieving, 7-50 
Archived files, 7-1 
Archiving , 

Marking files for, 7-31 
Archiving files, 7-3, 7-43, 
7-47, 7-48 

Archiving marked files, 

7-46 

Arguments , 

MAKLIB switch, 6-3 
ASCII file comparison 
switches, 4-3 

ASCII mode file comparison, 
4-3 

ASCII output file format, 

4-4 

ASCII output file header, 

4-4 

ASCII output file header 
example, 4-4 
ASCII text blocks, 6-6 


ASINCE command, 

DUMPER, 7-8, 7-9, 7-51 
Assembler , 

MAKLIB MACRO, 6-24, 6-25 
Assembler source files, 
MACRO, 5-1 

ASSEMBLER source files, 
MACRO, 4-11 

Assembler source files, 
MACRO, 4-3 

Assembly language source 
files , 

Comparing, 4-3, 4-11 
Assigning a tape drive, 7-4 
Assigning a tape drive 
example, 7-4 

.ASSOCIATED pseudo-op, 6-21 


/B switch, 

CREF, 5-4 
FILCOM, 4-3, 4-11 
Backing up files, 7-44 
Backup , 

Restoring files from, 

7- 46 

Backup files, 7-1 
Batch job, 

MAIL used in a, 2-6 
Batch job control file 
example, 2-6 

Batch job PLEASE command, 

8 - 1 

BEFORE command, 

DUMPER, 7-8, 7-51 
Beginning of tape, 
Positioning at, 7-21 
Binary file comparison 
switches, 4-8 
Binary file types, 4-2 
Binary files, 

Comparing, 4-7 
Listing, 4-7 

Binary output file format, 
4-8 

Binary output file header, 
4-8 

Blank lines in file 
comparison, 4-3 
Blocking, 7-15, 7-16 
Blocking factors, 7-15 
BLOCKING-FACTOR command, 
DUMPER SET, 7-16 
Blocks , 

ASCII text, 6-6 


Index-1 



INDEX (CONT.) 


Blocks (Cont . ) 

DUMPER File Descriptor, 
7-28 

END, 6-4 

Inserting INDEX, 6-19 
REQUEST, 6-6 
REQUIRE, 6-6 
SYMBOL, 6-20 
TRACE, 6-5, 6-20, 6-21, 
6-26 

Blocks format, 

TRACE, 6-41 
BUILD command, 3-1 


/C switch, 

CREF, 5-4 
FILCOM, 4-3, 4-11 
CANCEL command, 

PLEASE, 8-5 
CANCEL MOUNT-REQUEST 
command, 7-50 
Canceling outstanding 

PLEASE messages, 8-5 
Capabilities in DUMPER, 
Enabling, 7-1, 7-42 
Capabilities in MAIL, 
Enabling, 2-5 
Capabilities in RDMAIL, 
Enabling, 3-2 
Change bars, 

FILCOM, 4-4, 4-7, 4-11 
Characters , 

. CRF file control, 5-15 
. CRF input file control, 

5-14, 5-16, 5-17 
Radix-50, 6-21 
SIXBIT, 6-21 
CHECK command, 

DUMPER, 7-27, 7-51 
Checking , 

Continuing, 7-19 
CHECKSUM command, 

DUMPER, 7-8, 7-18, 7-51 
Checksum during SAVE, 
Specifying a, 7-18 
COBOL compiler source files, 
5-1 

Code and symbol table in 
modules, 6-25 
Code ending point, 

MAKLIB, 6-23 
Code format, 

.FIX files, 6-43 
Code in modules, 

Deleting, 6-22 
Inserting, 6-22 


Code insertion restriction, 

6-22 

Code segment example, 6-23 
Command , 

ARCHIVE, 7-31 

Batch job PLEASE, 8-1 

BUILD, 3-1 

CANCEL MOUNT-REQUEST, 

7-50 

COMPILE, 5-1, 5-2 
CONTINUE, 8-2 
Continuing an interrupted, 

7-30 

DEFINE, 1-2, 1-3 
DUMPER ABEFORE, 7-8, 7-51 
DUMPER ACCOUNT, 7-8, 7-14, 
7-51 

DUMPER ASINCE, 7-8, 7-9, 
7-51 

DUMPER BEFORE, 7-8, 7-51 
DUMPER CHECK, 7-27, 7-51 
DUMPER CHECKSUM, 7-8, 

7-18, 7-51 

DUMPER CONTINUE, 7-30, 7-52 
DUMPER CREATE, 7-43, 7-46, 
7-52 

DUMPER CTRL/E, 7-29, 7-52 
DUMPER DENSITY, 7-8, 7-15, 
7-52 

DUMPER DIRECTORIES, 7-8, 
7-11, 7-52 

DUMPER DISMOUNT TAPE, 7-5 
DUMPER EOT, 7-20, 7-21, 

7-52 

DUMPER EXIT, 7-7, 7-52 
DUMPER FILES, 7-8, 7-11, 
7-52 

DUMPER FORMAT, 7-8, 7-16, 
7-53 

DUMPER HELP, 7-7, 7-53 
DUMPER INDUSTRY, 7-8, 

7-16, 7-53 

DUMPER INITIAL, 7-8, 7-19, 
7-53 

DUMPER INTERCHANGE, 7-8, 
7-16, 7-53 

DUMPER LIST, 7-8, 7-12, 

7-53 

DUMPER MBEFORE , 7-8, 7-9, 
7-53 

DUMPER MOUNT TAPE, 7-4, 

7-6 

DUMPER MSINCE, 7-8, 7-9, 
7-53 

DUMPER NO CHECKSUM, 7-51 
DUMPER NO CREATE, 7-52 
DUMPER NO DIRECTORIES, 

7-11, 7-52 


Index-2 



INDEX (CONT.) 


Command (Cont.) 

DUMPER NO FILES , 7-12, 

7-52 

DUMPER NO INDUSTRY, 7-53 
DUMPER NO INTERCHANGE, 

7-53 

DUMPER NO LIST, 7-13, 

7-53 

DUMPER NO SILENCE, 7-13, 
7-55 

DUMPER PARITY, 7-8, 7-15, 
7-53 

DUMPER PRINT, 7-29, 7-54 
DUMPER PROTECTION, 7-8, 
7-14, 7-54 

DUMPER QUIT, 7-7, 7-54 
DUMPER RESTORE, 7-23, 

7-26, 7-43, 7-46, 7-54 
DUMPER RETRIEVE, 7-43, 
7-50, 7-54 

DUMPER REWIND, 7-20, 7-21, 
7-54 

DUMPER REWIND SWITCHING, 
7-21 

DUMPER SAVE, 7-23, 7-24, 
7-55 

DUMPER SET 

BLOCKING-FACTOR, 7-8 , 
7-15, 7-16, 7-55 
DUMPER SET TAPE-NUMBER, 
7-8, 7-19, 7-55 
DUMPER SILENCE, 7-8, 7-13, 
7-55 

DUMPER SINCE, 7-8, 7-9, 
7-55 

DUMPER SKIP, 7-22, 7-56 
DUMPER SKIP n, 7-20 
DUMPER SSNAME , 7-8, 7-18, 
7-56 

DUMPER SUPERSEDE, 7-8, 
7-10, 7-56 

DUMPER TAPE, 7-8, 7-14, 
7-56 

DUMPER UNLOAD, 7-20, 7-23, 
7-56 

GET, 2-3 
INFORMATION 

ARCHIVE-STATUS , 7-31 
INFORMATION MAIL, 2-4, 

3-2 

INFORMATION SYSTEM-STATUS, 
7-3 

INFORMATION VOLUMES, 7-6 
LOAD-class, 5-1 
PLEASE CANCEL, 8-5 
PLEASE EXIT, 8-5 
PLEASE MESSAGE, 8-5 
PLEASE SEND, 8-4 
REENTER, 2-3 


Command (Cont . ) 

REFUSE SYSTEM-MESSAGES, 

3-2 

RESET, 8-2 

Running CREF as a, 5-5 
SET MAIL-WATCH, 3-2 
TALK, 2-4 
TRANSLATE, 1-2 
TYPE, 4-5, 5-6, 6-5 
Command categories , 

DUMPER, 7-7 
Command in DUMPER, 

Halting a, 7-29 
Command line format, 

PLEASE MESSAGE, 8-5 
PLEASE SEND, 8-4 
Command string format, 

CREF, 5-3 
FILCOM, 4-1 
MAKLIB, 6-3 

Command string requirements, 
MAKLIB, 6-4, 6-7, 6-19, 

6- 25 

Commands , 

DUMPER Action, 7-7, 7-23, 

7- 24 

DUMPER Status-Setting, 

7-7, 7-8 

DUMPER Tape-Positioning, 
7-7, 7-20 

DUMPER Transfer, 7-23 
MAKLIB multi-line, 6-4 
PLEASE, 8-1, 8-4 
Comments and spaces in file 
comparison, 4-3 
Communicating with the 
operator, 8-1 
COMND.CMD file, 3-2 
Comparing ASCII files, 4-3 
Comparing ASCII files 
example , 4-5 , 4-6 
Comparing assembly language 
source files, 4-3, 4-11 
Comparing binary files, 4-7 
Comparing binary files 
example, 4-9 

Comparing executable files 
example, 4-10 
COMPILE command, 5-1, 5-2 
COMPILE command example, 

5-1, 5-2 

Compiler source files, 
ALGOL, 5-1 
COBOL, 5-1 
FORTRAN, 5-1 

Compiling a program, 5-1, 
5-2 

Compiling ALGOL source 
files example, 5-9 


Index-3 



INDEX (CONT.) 


Compiling FORTRAN source 
files example, 5-8 
Compiling MACRO source 
files example, 5-6 
CONTINUE command, 8-2 
DUMPER, 7-30, 7-52 
Continuing an interrupted 
command, 7-30 
Continuing checking, 7-19 
Continuing restoring, 7-19 
Continuing saving, 7-19 
Control characters, 

. CRF file, 5-15 
. CRF input file, 5-14, 
5-16, 5-17 

Control pseudo-op, 6-20 
CREATE command, 

DUMPER, 7-43, 7-46, 7-52 
Creating a saveset, 7-24 
Creating .CRF files, 5-1 
Creating .CRF files example, 
5-2 

Creating .FIX files, 6-20 
Creating libraries, 6-9 
CREF, 

Running, 5-1 
Running other programs 
from, 5-6 

CREF /A switch, 5-4 
CREF as a command. 

Running, 5-5 
CREF as a program. 

Running, 5-5 
CREF /B switch, 5-4 
CREF /C switch, 5-4 
CREF command string format, 
5-3 

CREF /D switch, 5-4 
CREF destination file spec, 
5-3 

CREF error messages, 5-10 
CREF error status codes, 

5-14 

CREF example, 5-6 
CREF file access errors, 

5-13 

CREF /H switch, 5-4 
CREF indirect file, 5-5 
CREF informational messages, 
5-10 

CREF /K switch, 5-4 
CREF /M switch, 5-4 
CREF MACRO symbols and 
references example , 

5-18 

CREF message variables, 

5-10 

CREF /O switch, 5-4 

CREF /O switch example, 5-5 


CREF octal codes, 5-13 
CREF /P switch, 5-4 
CREF program, 5-1 
CREF /R switch, 5-4 
CREF /S switch, 5-4 
CREF source file spec, 5-3 
/CREF switch, 5-1, 5-2 
/CREF switch example, 5-1, 
5-2 

CREF SWITCH . INI file, 5-5 

CREF switches, 5-3 

CREF /T switch, 5-4 

CREF technical notes, 5-14 

CREF /W switch, 5-4 

CREF warning messages, 5-10 

CREF /Z switch, 5-4 

.CRF file control 

characters, 5-15 
.CRF files, 

Creating, 5-1 
.CRF input file control 

characters, 5-14, 5-16, 
5-17 

.CRF input file format, 

5-14 

Cross-reference listings, 
5-1 

Producing, 5-2 
tables in, 5-2 
CTRL/E command, 

DUMPER, 7-29, 7-52 
CTRL/H, 

MAIL, 2-1, 2-4 
CTRL/V, 

MAIL, 2-2 
CTRL/Z , 

MAIL, 2-2 


/D switch, 

CREF, 5-4 
Date , 

Edit creation, 6-21 
Date and time, 

RDMAIL , 3-3 
Transferring files by, 

7-8, 7-9 

.DATE pseudo-op, 6-6, 6-21 
Deactivating an edit, 6-23 
Debugging, 5-1, 6-20 
DEFINE command, 1-2, 1-3 
DEFINE command example, 1-3, 
5-6 

Defining logical names 

example, 1-3, 5-6, 7-4, 

7-5 

/DELETE switch, 

MAKLIB, 6-7, 6-9, 6-20, 6-27 


Index-4 



INDEX (CONT.) 


/DELETE switch example, 
MAKLIB, 6-11 
/DELETE switch figure, 
MAKLIB, 6-10 

Deleting a saveset, 7-25 
Deleting code in modules, 
6-22 

Deleting local symbols, 

6-20 
Density , 

Setting tape, 7-15 
DENSITY command, 

DUMPER, 7-8, 7-15, 7-52 
Destination file spec, 

CREF, 5-3 
DUMPER, 7-23 
FILCOM, 4-1 
MAKLIB, 6-3 
DIRECTORIES command , 

DUMPER, 7-8, 7-11, 

7-52 

Directory , 

PS: <REMARKS>, 2-5 
PS : <SYSTEM> , 2-5, 2-6 
Restoring a, 7-46 
Sending mail to a 
non-files-only, 2-5 
DIRECTORY command example, 
7-10 
Disk , 

Transferring files from 
tape to, 7-26 
Disk and tape, 

Transferring between, 

7-2 

Disk file, 

Overwriting a, 7-10, 7-27 
Disk to tape, 

Transferring files from, 
7-24 

DISMOUNT TAPE command, 
DUMPER, 7-5 

Dismounting a tape, 7-5 
DUMPER, 

Enabling capabilities in, 
7-1, 7-42 

Halting a command in, 

7-29 

Logical names in, 7-5 
Nonpr ivileged user in, 

7-7 

Privileged user in, 7-42 
Reading a tape from an 
earlier version of, 

7-16 

Running, 7-6 
Stopping, 7-7 

DUMPER ABEFORE command, 7-8, 
7-51 


DUMPER ACCOUNT command, 7-8 
7-14, 7-51 

DUMPER Action commands, 7-7 
7-23, 7-24 

DUMPER /ARCHIVE switch, 

7-43, 7-48, 7-55 
DUMPER /ARCHIVE switch 
example, 7-48 

DUMPER ASINCE command, 7-8, 
7-9, 7-51 

DUMPER BEFORE command, 7-8, 
7-51 

DUMPER BEFORE command 
example, 7-9 
DUMPER BSINCE command 
example, 7-10 

DUMPER CHECK command, 7-27, 
7-51 

DUMPER CHECK command 
example, 7-35 
DUMPER CHECKSUM command, 
7-8, 7-18, 7-51 
DUMPER CHECKSUM command 
example, 7-18, 7-34 
DUMPER command categories, 
7-7 

DUMPER CONTINUE command, 
7-30, 7-52 

DUMPER CONTINUE command 
example, 7-30 

DUMPER CREATE command, 7-43 
7-46, 7-52 

DUMPER CTRL/E command, 7-29 
7-52 

DUMPER DENSITY command, 7-8 
7-15, 7-52 

DUMPER destination file 
spec, 7-23 

DUMPER DIRECTORIES command, 
7-8, 7-11, 7-52 
DUMPER DISMOUNT TAPE 
command, 7-5 

DUMPER EOT command, 7-20, 
7-21, 7-52 

DUMPER EOT command example, 
7-21 

DUMPER error messages, 7-57 
DUMPER EXIT command, 7-7, 
7-52 

DUMPER EXIT command example 
7-37 

DUMPER FDB , 7-28 
DUMPER FDB example, 7-28 
DUMPER features, 7-2 
DUMPER File Descriptor 
Blocks, 7-28 

DUMPER FILES command, 7-8, 
7-11, 7-52 


Index-5 



INDEX 


(CONT. ) 


DUMPER FILES command 
example, 7-12 

DUMPER FORMAT command, 7-8, 
7-16, 7-53 

DUMPER /FULL-INCREMENTAL 
switch, 7-42, 7-44, 

7-55 

DUMPER /FULL-INCREMENTAL 
switch example, 7-44 
DUMPER HELP command, 7-7, 
7-53 

DUMPER /INCREMENTAL :n 
switch, 7-42, 7-44, 

7-55 

DUMPER INDUSTRY command, 

7-8, 7-16, 7-53 
DUMPER INITIAL command, 7-8, 
7-19, 7-53 

DUMPER INTERCHANGE command, 
7-8, 7-16, 7-53 
DUMPER INTERCHANGE command 
example, 7-17 
DUMPER LIST command, 7-8, 
7-12, 7-53 

DUMPER LIST command example, 
7-13 

DUMPER MBEFORE command, 7-8, 
7-9, 7-53 

DUMPER message variables, 
7-57 

DUMPER /MIGRATE switch, 

7-43, 7-49, 7-55 
DUMPER MOUNT TAPE command, 
7-4, 7-6 

DUMPER MOUNT TAPE command 
example, 7-4, 7-5 
DUMPER MSINCE command, 7-8, 
7-9, 7-53 

DUMPER MSINCE command 
example, 7-10 

DUMPER NO CHECKSUM command, 
7-51 

DUMPER NO CREATE command, 
7-52 

DUMPER NO DIRECTORIES 
command, 7-11, 7-52 
DUMPER NO DIRECTORIES 

command example, 7-11 
DUMPER NO FILES command, 
7-12, 7-52 

DUMPER NO INDUSTRY command, 
7-53 

DUMPER NO INTERCHANGE 
command, 7-53 
DUMPER NO LIST command, 

7-13, 7-53 

DUMPER NO SILENCE command, 
7-13, 7-55 


DUMPER /NOINCREMENTAL 
switch, 7-43, 7-44, 

7-55 

DUMPER /NOUNLOAD switch, 
7-22 

DUMPER PARITY command, 7-8, 
7-15, 7-53 

DUMPER PRINT command, 7-29, 
7-54 

DUMPER PRINT command 

example, 7-29, 7-34, 
7-41 

DUMPER program, 7-1 
DUMPER PROTECTION command, 
7-8, 7-14, 7-54 
DUMPER QUIT command, 7-7, 
7-54 

DUMPER RESTORE command , 

7-23, 7-26, 7-43, 7-46, 
7-54 

DUMPER RESTORE command 
example, 7-27, 7-38 
DUMPER RETRIEVE command, 
7-43, 7-50, 7-54 
DUMPER REWIND command, 7-20 
7-21, 7-54 

DUMPER REWIND SWITCHING 
command, 7-21 
DUMPER REWIND SWITCHING 
command example, 7-21 
DUMPER SAVE command, 7-23, 
7-24, 7-55 

DUMPER SAVE command example 
7-24, 7-31, 7-34, 7-36, 
7-37 

DUMPER SET BLOCKING-FACTOR 
command, 7-8, 7-15, 
7-16, 7-55 

DUMPER SET TAPE-NUMBER 
command, 7-8, 7-19, 

7-55 

DUMPER SET TAPE-NUMBER 

command example, 7-20 
DUMPER SILENCE command, 7-8 
7-13, 7-55 

DUMPER SINCE command, 7-8, 
7-9, 7-55 

DUMPER SKIP command, 7-22, 
7-56 

DUMPER SKIP command example 
7-22, 7-41 

DUMPER SKIP n command, 7-20 
DUMPER source file spec, 
7-23 

DUMPER SSNAME command, 7-8, 
7-18, 7-56 

DUMPER Status-Setting 
commands, 7-7, 7-8 


Index-6 



INDEX (CONT.) 


DUMPER SUPERSEDE command, 
7-8, 7-10, 7-56 
DUMPER SUPERSEDE command 
example, 7-10 
DUMPER TAPE command, 7-8, 
7-14, 7-56 

DUMPER /TAPE-INFORMATION 
switch, 7-51 
DUMPER Tape-Positioning 
commands, 7-7, 7-20 
DUMPER Transfer commands, 
7-23 

DUMPER UNLOAD command, 7-20, 
7-23, 7-56 

DUMPER /VOLIDS switch, 7-5 
DUMPER warning messages, 

7-57 

DUMPER wildcards, 7-23 
DUMPER /WRITE-ENABLE switch 
example, 7-4 
DUMPER /WRITE-ENABLED 
switch, 7-4 

Dumping a file example, 4-9 
Dumping files, 4-8 
Duplicate user names, 2-1 


/E switch, 

FILCOM, 4-8, 4-11 
Edit, 

Activating an, 6-23 
Active, 6-20 
Deactivating an, 6-23 
Inactive, 6-20 
Related, 6-21 
Edit creation date, 6-21 
Edit creator initials, 6-21 
Edit ending point, 

MAKLIB, 6-23 

Edit history information, 
6-20 

Edit locations, 
changing, 6-21 
Edit name, 6-21 
.EDIT pseudo-op, 6-20, 6-21 
Edit version number, 6-21 
Editing libraries, 6-2, 

6-20 

Edits to libraries, 

Listing, 6-5 

Enabling capabilities in 
DUMPER, 7-1, 7-42 
Enabling capabilities in 
MAIL, 2-5 

Enabling capabilities in 
RDMAIL , 3-2 
END blocks, 6-4 


End-of -Tape , 

Positioning at, 7-21 
.ENDE pseudo-op, 6-20, 6-23 
. ENDI pseudo-op, 6-22, 6-23 
. ENDI pseudo-op example, 

6- 23 

Entry points in libraries, 
Listing, 6-5 
EOT command, 

DUMPER, 7-20, 7-21, 7-52 
Error messages, 

CREF, 5-10 
DUMPER, 7-57 
FILCOM, 4-12 
MAIL, 2-3, 2-6 
MAKLIB, 6-28 
PLEASE, 8-6 
RDMAIL, 3-7 

Error recovery procedure, 
MAIL, 2-3 

Error status codes, 

CREF, 5-14 
Errors , 

CREF file access, 5-13 
FILCOM file access, 4-13, 
4-14 

Errors in sending mail, 2-3 
Example , 

ALGOL CREF listing, 5-9 
ASCII output file header, 
4-4 

Assigning a tape drive, 

7- 4 

Batch job control file, 
2-6 

Code segment, 6-23 
Comparing ASCII files, 
4-5, 4-6 

Comparing binary files, 
4-9 

Comparing executable 
files, 4-10 

COMPILE command, 5-1, 5-2 
Compiling ALGOL source 
files, 5-9 

Compiling FORTRAN source 
files, 5-8 

Compiling MACRO source 
files, 5-6 

Creating . CRF files, 5-2 
CREF, 5-6 

CREF MACRO symbols and 
references, 5-18 
CREF /O switch, 5-5 
/CREF switch, 5-1, 5-2 
DEFINE command, 1-3, 5-6 
Defining logical names, 
1-3, 5-6, 7-4, 7-5 


Index-7 



INDEX (CONT.) 


Example (Cont.) 

DIRECTORY command, 7-10 
DUMPER /ARCHIVE switch, 
7-48 

DUMPER BEFORE command, 

7-9 

DUMPER BSINCE command, 

7-10 

DUMPER CHECK command, 

7-35 

DUMPER CHECKSUM command, 
7-18, 7-34 

DUMPER CONTINUE command, 
7-30 

DUMPER EOT command, 7-21 
DUMPER EXIT command, 7-37 
DUMPER FDB , 7-28 
DUMPER FILES command, 

7-12 

DUMPER /FULL-INCREMENTAL 
switch, 7-44 
DUMPER INTERCHANGE 
command, 7-17 
DUMPER LIST command, 7-13 
DUMPER MOUNT TAPE command, 
7-4, 7-5 

DUMPER MSINCE command, 

7-10 

DUMPER NO DIRECTORIES 
command, 7-11 
DUMPER PRINT command, 

7-29, 7-34, 7-41 
DUMPER RESTORE command, 
7-27, 7-38 

DUMPER REWIND SWITCHING 
command, 7-21 
DUMPER SAVE command, 7-24, 
7-31, 7-34, 7-36, 7-37 
DUMPER SET TAPE-NUMBER 
command, 7-20 
DUMPER SKIP command, 7-22, 
7-41 

DUMPER SUPERSEDE command, 
7-10 

DUMPER /WRITE-ENABLE 
switch, 7-4 
Dumping a file, 4-9 
. ENDI pseudo-op, 6-23 
FILCOM /C switch, 4,-6 
FILCOM /nL switch, 4-10 
FILCOM /nU switch, 4-10 
FILCOM /Q switch, 4-9, 

4- 10 

FILCOM /U switch, 4-7 
FILCOM /W switch, 4-10 
.FIX files, 6-26 
FORTRAN CREF listing, 

5- 8 

GET command, 2-3 


Example (Cont . ) 

INFORMATION 

ARCHIVE-STATUS command, 

7- 47 

INFORMATION SYSTEM-STATUS 
command, 7-3 
INFORMATION VOLUMES 
command, 7-6 
.INSERT pseudo-op, 6-23 
MACRO CREF listing, 5-6, 

5- 21 

MAIL indirect file, 2-4 
MAKLIB /APPEND switch, 

6- 9 

MAKLIB /DELETE switch, 

6-11 

MAKLIB edit, 6-23, 6-26 
MAKLIB /EXTRACT switch, 
6-13 

MAKLIB /FIX switch, 6-26 
MAKLIB /INDEX switch, 6-20 
MAKLIB /INSERT switch, 
6-15, 6-17 

MAKLIB /LIST switch, 6-4, 
6-9, 6-11, 6-13, 6-15, 
6-17, 6-19 

MAKLIB /LOAD switch, 6-6 
MAKLIB /MASTER switch, 
6-15, 6-17, 6-18 
MAKLIB /NOLOCALS switch, 
6-20 

MAKLIB /POINTS switch, 6-5 
MAKLIB /REPLACE switch, 
6-18 

MAKLIB /TRACE switch, 6-6 
MAKLIB /WHO switch, 6-26 
Opcode table, 5-6 
PLEASE CANCEL command, 

8- 5 

PLEASE EXIT command, 8-5 
PLEASE MESSAGE command, 

8-5 

PLEASE /MESSAGE switch, 

8-3 

PLEASE /NOWAIT switch, 8-3 
PLEASE program level, 8-4 
PLEASE SEND command, 8-4 
PLEASE TOPS-20 command 
level, 8-2 

Procedure nesting table, 
5-9 

RDMAIL /ALL switch, 3-5 
RDMAIL /HELP switch, 3-4 
RDMAIL /LIST switch, 3-5 
RDMAIL 

/MESSAGE-OF-THE-DAY 
switch, 3-5 

RDMAIL /PERUSE switch, 

3-6 


Index-8 



INDEX (CONT.) 


Example (Cont . ) 

RDMAIL /STOP switch, 

3-6 

Reading another user's 
mail, 3-2 

REENTER command, 2-3 
Running CREF as a command, 
5-5 

Running CREF as a program, 
5-5 

Sending mail to 
PS: <REMARKS>, 2-5 
Sending mail to 
PS : <SYSTEM> , 2-5 
SWITCH . INI file, 5-6 
TRANSLATE command, 1-2 
TYPE command, 4-5, 4-6, 

5- 6, 6-5 

VDIRECTORY command, 7-10 
.EXE file, 6-1 
Executable program, 6-1 
EXIT command, 

DUMPER, 7-7, 7-52 
PLEASE, 8-5 
/EXIT switch, 

MAKLIB, 6-27 
/EXTRACT switch, 

MAKLIB, 6-7, 6-11, 6-20, 

6- 27 

/EXTRACT switch example, 
MAKLIB, 6-13 
/EXTRACT switch figure, 
MAKLIB, 6-11 
Extracting modules from 
libraries, 6-11 


FDB , 

DUMPER, 7-28 
Features , 

DUMPER, 7-2 

Fields of file specs, 1-2 
Figure , 

Generating an .EXE file, 
6-1 

Generating libraries, 6-2 

MAIL/MAILER, 2-9 

MAKLIB /APPEND switch, 

6-8 

MAKLIB /DELETE switch, 
6-10 

MAKLIB /EXTRACT switch, 
6-11 

MAKLIB /INSERT switch, 
6-14, 6-15 

MAKLIB /REPLACE switch, 
6-17 

Pseudo-op order , 6-24 


FILCOM, 

Generation numbers in, 

4-2 

Logical names in, 4-2 
Running, 4-1 
Stopping, 4-3 

FILCOM /A switch, 4-3, 4-11 
FILCOM /B switch, 4-3, 4-11 
FILCOM /C switch, 4-3, 4-11 
FILCOM /C switch example, 

4-6 

FILCOM change bars, 4-4, 

4-7, 4-11 

FILCOM command string 
format, 4-1 

FILCOM destination file 
spec, 4-1 

FILCOM /E switch, 4-8, 4-11 
FILCOM error messages, 4-12 
FILCOM file access errors, 
4-13, 4-14 

FILCOM file types, 4-2 
FILCOM /H switch, 4-3, 4-8, 
4-11 

FILCOM help text, 4-3, 4-8, 
4-11 

FILCOM message variables, 
4-12 

FILCOM /nL switch, 4-4, 4-8, 
4-11 

FILCOM /nL switch example, 
4-10 

FILCOM nonstandard file 
types, 4-8, 4-11 
FILCOM /nU switch, 4-8, 

4-11 

FILCOM /nU switch example, 
4-10 

FILCOM octal codes, 4-13, 
4-14 

FILCOM program, 4-1 
FILCOM /Q switch, 4-4, 4-8, 
4-11 

FILCOM /Q switch example, 
4-9, 4-10 

FILCOM /S switch, 4-4, 4-11 
FILCOM source file spec, 

4-1 

FILCOM switches, 4-2, 4-11 
FILCOM /U switch, 4-4, 4-11 
FILCOM /U switch example, 

4-7 

FILCOM /W switch, 4-8, 4-11 
FILCOM /W switch example, 
4-10 

FILCOM /X switch, 4-8, 4-11 
File , 

COMND.CMD, 3-2 
CREF indirect, 5-5 


Index-9 



INDEX (CONT.) 


File (Cont.) 

CREF SWITCH . INI , 5-5 
.EXE, 6-1 

MAIL indirect, 2-4 
MAIL . CPY , 2-3, 2-9 
MAIL . TXT , 2-9, 3-1 
MAKLIB indirect, 6-3 
MAKLIB SWITCH.INI, 6-3 
Overwriting a disk, 7-10, 
7-27 

.REL, 6-1 

File access errors, 

CREF, 5-13 
FILCOM, 4-13, 4-14 
File account during RESTORE, 
Specifying, 7-14 
File comparison, 

ASCII mode, 4-3 
Blank lines in, 4-3 
Comments and spaces in, 

4-3 

Limited, 4-8 
Match criteria in, 4-4 
Nonsharable save, 4-8 
Nonstandard, 4-8 
Quick, 4-4, 4-8 
Sharable save, 4-8 
Spaces and tabs in, 4-4 
status of, 4-3 
Update mode, 4-4 
File comparison switches, 
ASCII, 4-3 
Binary, 4-8 

File Descriptor Blocks, 
DUMPER, 7-28 
File format, 

ASCII output, 4-4 
Binary output, 4-8 
File generation numbers, 

1-2 

File header, 

ASCII output, 4-4 
Binary output, 4-8 
File of filenames during 
SAVE, 

Producing a, 7-12 
File of user names, 2-4 
File spec, 

CREF destination, 5-3 
CREF source, 5-3 
DUMPER destination, 7-23 
DUMPER source, 7-23 
FILCOM destination, 4-1 
FILCOM source, 4-1 
MAKLIB destination, 6-3 
MAKLIB source, 6-3 
File specs, 

Fields of, 1-2 
Typing, 1-1, 1-2 


File status. 

Invisible, 7-48 
; OFFLINE , 7-49 
File types, 

Binary, 4-2 
FILCOM, 4-2 

FILCOM nonstandard, 4-8, 

4- 11 

Nonsharable save, 4-2 
Offset address, 4-2 
Sharable save, 4-2 
Filenames during SAVE, 

Producing a file of, 7-12 
Files , 

ALGOL compiler source, 

5- 1 

Archived, 7-1 
Archiving, 7-3, 7-43, 
7-47, 7-48 

Archiving marked, 7-46 
Backing up, 7-44 
Backup, 7-1 
COBOL compiler source, 

5-1 

Comparing ASCII, 4-3 
Comparing assembly 

language source, 4-3, 

4- 11 

Comparing binary, 4-7 
Creating .CRF, 5-1 
Creating .FIX, 6-20 
Dumping, 4-8 
FORTRAN compiler source, 

5- 1 

Listing binary, 4-7 
MACRO assembler source, 
5-1 

MACRO ASSEMBLER source, 
4-11 

MACRO Assembler source, 
4-3 

Master library, 6-7 
Migrated, 7-1 
Migrating, 7-3, 7-43, 

7-49 

Nonsharable save, 4-2, 
4-7, 4-8, 4-11 
relocatable, 6-1 
Restoring archived and 
migrated, 7-50 
Retrieving archived and 
migrated, 7-50 
Sharable save, 4-2, 4-7, 
4-8, 4-11 
Transaction, 6-3 
FILES command, 

DUMPER, 7-8, 7-11, 7-52 
Files during RESTORE, 
Renaming, 7-26 


Index-10 



INDEX (CONT.) 


Files during SAVE, 
Renaming, 7-24 
Files for archiving, 
Marking, 7-31 
Files from backup, 
Restoring, 7-46 
Files from disk to tape, 
Transferring, 7-24 
Files from tape to disk, 
Transferring, 7-26 
Files incrementally, 
Saving, 7-43 
.FIX files, 

Creating, 6-20 
.FIX files code format, 
6-43 

.FIX files example, 6-26 
/FIX switch, 

MAKLIB, 6-5, 6-25, 6-26, 
6-27 

/FIX switch example, 
MAKLIB, 6-26 
FORMAT command, 

DUMPER, 7-8, 7-16, 7-53 
FORTRAN compiler source 
files, 5-1 

FORTRAN CREF listing 
example, 5-8 

/FULL-INCREMENTAL switch, 
DUMPER, 7-42, 7-44, 7-55 


Generating an .EXE file 
figure, 6-1 

Generating libraries figure, 
6-2 

Generation numbers , 

File, 1-2 

Generation numbers in 
FILCOM, 4-2 
GET command, 2-3 
GET command example, 2-3 
Global symbols, 6-20 


/H switch, 

CREF, 5-4 

FILCOM, 4-3, 4-8, 4-11 
Halting a command in DUMPER, 
7-29 
Header , 

ASCII output file, 4-4 
Binary output file, 4-8 
HELP command, 

DUMPER, 7-7, 7-53 
/HELP switch, 

RDMAIL, 3-4 


Help text, 

FILCOM, 4-3, 4-8, 4-11 
RDMAIL, 3-4 

High-segment break, 6-4 


Identifying a mounted tape, 
7-14 

Inactive edit, 6-20 
/INCREMENTAL: n switch, 

DUMPER, 7-42, 7-44, 7-55 
INDEX blocks, 

Inserting, 6-19 
/INDEX switch, 

MAKLIB, 6-19, 6-27 
/INDEX switch example, 
MAKLIB, 6-20 
Indirect file, 

CREF, 5-5 
MAIL, 2-4 
MAKLIB, 6-3 
Indirect file example, 

MAIL, 2-4 

Indirect file in MAIL, 
Retrieving an, 2-4 
INDUSTRY command, 

DUMPER, 7-8, 7-16, 7-53 
Information about libraries 
Obtaining, 6-2, 6-4 
INFORMATION ARCHIVE-STATUS 
command, 7-31 

INFORMATION ARCHIVE-STATUS 
command example, 7-47 
INFORMATION MAIL command, 
2-4, 3-2 

INFORMATION SYSTEM-STATUS 
command, 7-3 

INFORMATION SYSTEM-STATUS 
command example, 7-3 
INFORMATION VOLUMES command 
7-6 

INFORMATION VOLUMES command 
example, 7-6 
Informational messages, 
CREF, 5-10 
PLEASE, 8-6 
INITIAL command, 

DUMPER, 7-8, 7-19, 7-53 
Initials , 

Edit creator, 6-21 
Initials MAKLIB user, 6-26 
.INSERT pseudo-op, 6-22, 
6-23 

.INSERT pseudo-op example, 
6-23 

/INSERT switch, 

MAKLIB, 6-7, 6-13, 6-27 


Index-11 



INDEX 


(CONT. ) 


/INSERT switch example, 
MAKLIB, 6-15, 6-17 
/INSERT switch figure, 
MAKLIB, 6-14, 6-15 
Inserting code in modules, 
6-22 

Inserting INDEX blocks, 

6-19 

Inserting modules into 
libraries, 6-13 
In ter -Process Communication 
Facility, 2-9 
INTERCHANGE command, 

DUMPER, 7-8, 7-16, 7-53 
INTERCHANGE mode, 7-15 
Invalid RDMAIL switches, 

3-7 

Invalid user names, 2-1 
Invisible file status, 7-48 
Invoking the utilities, 

1-1 

IPCF packet, 2-9 


JFN , 7-2 

Job file number, 7-2 


/K switch, 
CREF, 5-4 


Labeled tape, 7-3, 7-5 
Libraries, 6-1 

Appending modules to, 6-7 
Creating, 6-9 
Editing, 6-2, 6-20 
Extracting modules from, 
6-11 

Inserting modules into, 
6-13 

Listing edits to, 6-5 
Listing entry points in, 
6-5 

Listing modules in, 6-4 
Loading instructions in, 
6-6 

Manipulating, 6-2, 6-7 
Master, 6-3 
Modifying, 6-2, 6-19 
Obtaining information 
about, 6-2, 6-4 
Removing modules from, 

6-9 

Replacing modules in, 

6-17 


Libraries figure, 

Generating, 6-2 
Limited file comparison, 

4- 8 

Line printer , 

Printing your messages on 
the, 3-5 

LINK program, 6-1, 6-2, 6-5, 
6-19 

LIST command, 

DUMPER, 7-8, 7-12, 7-53 
/LIST switch, 

MAKLIB, 6-4, 6-27 
RDMAIL, 3-4, 3-5 
/LIST switch example, 

MAKLIB, 6-9, 6-11, 6-13, 
6-15, 6-17, 6-19 
Listing binary files, 4-7 
Listing edits to libraries, 

6- 5 

Listing entry points in 
libraries, 6-5 
Listing modules in 
libraries, 6-4 
Listings, 

Cross-reference, 5-1 
Producing cross-reference, 

5- 2 

tables in cross-reference, 
5-2 

/LOAD switch, 

MAKLIB, 6-4, 6-6, 6-27 
/LOAD switch example, 

MAKLIB, 6-6 

LOAD-class command, 5-1 
Loading instructions in 
libraries, 6-6 
Local symbols, 

Deleting, 6-20 
Logical names, 1-2, 1-3 
Logical names example, 
Defining, 1-3, 5-6, 7-4, 

7- 5 

Logical names in DUMPER, 7-5 
Logical names in FILCOM, 

4-2 

Logical records, 

Setting, 7-15 
Low-segment break, 6-4 


/M switch, 

CREF, 5-4 
MACRO assembler, 

MAKLIB, 6-24, 6-25 
MACRO assembler source 
files, 5-1 


Index-12 



INDEX 


(CONT. ) 


MACRO ASSEMBLER source 
files, 4-11 

MACRO Assembler source 
files, 4-3 

MACRO CREF listing example, 
5-6, 5-21 

Macro names table, 

OPDEF and, 5-2 
MAIL, 

Enabling capabilities in, 

2- 5 
Mail , 

Errors in sending, 2-3 
notification of new, 2-2, 

3- 1, 3-2 

Reading another user's, 

3-2 

Reading new, 3-3 
Resending, 2-3 
MAIL, 

Retrieving an indirect 
file in, 2-4 
Running, 2-1 
Mail, 

status of new, 2-4, 3-2 
MAIL CTRL/H, 2-1, 2-4 
MAIL CTRL/V, 2-2 
MAIL CTRL/Z, 2-2 
MAIL error messages, 2-3, 

2-6 

MAIL error recovery 
procedure, 2-3 
MAIL indirect file, 2-4 
MAIL indirect file example, 
2-4 

MAIL message, 

Terminating a, 2-2 
MAIL multi-line entries, 2-2 
MAIL options, 2-4 
MAIL program, 2-1 
MAIL recipients, 2-1 
MAIL subject line, 2-2 
MAIL subject line special 
characters, 2-2 
MAIL technical notes, 2-9 
MAIL used in a batch job, 

2-6 

MAIL warning messages, 2-6 
MAIL . CPY file, 2-3, 2-9 
MAIL . TXT file, 2-9, 3-1 
MAIL/MAILER figure, 2-9 
MAILER program, 2-9 
MAKLIB, 

Running, 6-3 
stopping, 6-4 

MAKLIB /APPEND switch, 6-7, 
6-27 

MAKLIB /APPEND switch 
example, 6-9 


MAKLIB /APPEND switch 
figure, 6-8 

MAKLIB code ending point, 
6-23 

MAKLIB command string 
format, 6-3 
MAKLIB command string 


requirements, 6-4, 6-7 

6-19, 6-25 


MAKLIB /DELETE 

switch, 6-7 

6-9, 6-20, 

6-27 

MAKLIB /DELETE 

switch 

example, 6- 

-11 

MAKLIB /DELETE 

switch 


figure, 6-10 
MAKLIB destination file 
spec, 6-3 

MAKLIB edit ending point, 
6-23 

MAKLIB edit example, 6-23, 
6-26 

MAKLIB error messages, 6-28 
MAKLIB /EXIT switch, 6-27 
MAKLIB /EXTRACT switch, 6-7 , 
6-11, 6-20, 6-27 
MAKLIB /EXTRACT switch 
example, 6-13 
MAKLIB /EXTRACT switch 
figure, 6-11 

MAKLIB /FIX switch, 6-5, 
6-25, 6-26, 6-27 
MAKLIB /FIX switch example, 
6-26 

MAKLIB functions, 6-2 
MAKLIB /INDEX switch, 6-19, 
6-27 

MAKLIB /INDEX switch 
example, 6-20 
MAKLIB indirect file, 6-3 
MAKLIB /INSERT switch, 6-7, 
6-13, 6-27 

MAKLIB /INSERT switch 

example, 6-15, 6-17 
MAKLIB /INSERT switch 
figure, 6-14, 6-15 
MAKLIB /LIST switch, 6-4, 
6-27 

MAKLIB /LIST switch example 
6-4, 6-9, 6-11, 6-13, 
6-15, 6-17, 6-19 
MAKLIB /LOAD switch, 6-4, 
6-6, 6-27 

MAKLIB /LOAD switch example 
6-6 

MAKLIB MACRO assembler, 
6-24, 6-25 

MAKLIB /MASTER switch, 6-7, 
6-27 


Index-13 



INDEX (CONT.) 


MAKLIB /MASTER switch 

example, 6-15, 6-17, 

6-18 

MAKLIB message variables, 
6-28 

MAKLIB multi-line commands, 
6-4 

MAKLIB /NOLOCALS switch, 
6-19, 6-20, 6-27 
MAKLIB /NOLOCALS switch 
example, 6-20 

MAKLIB /POINTS switch, 6-4, 
6-5, 6-27 

MAKLIB /POINTS switch 
example, 6-5 
MAKLIB program, 6-1 
MAKLIB /REPLACE switch, 6-7, 
6-17, 6-20, 6-27 
MAKLIB /REPLACE switch 
example, 6-18 
MAKLIB /REPLACE switch 
figure, 6-17 

MAKLIB source file spec, 

6-3 

MAKLIB switch arguments, 

6-3 

MAKLIB SWITCH . INI file, 6-3 
MAKLIB switches, 6-2, 6-3 
MAKLIB technical notes, 

6-41 

MAKLIB /TRACE switch, 6-4, 
6-5, 6-20, 6-27 
MAKLIB /TRACE switch 
example, 6-6 
MAKLIB user, 

Initials, 6-26 
MAKLIB warning messages, 

6-28 

MAKLIB /WHO switch, 6-6, 
6-25, 6-26, 6-27 
MAKLIB /WHO switch example, 
6-26 

Manipulating libraries, 6-2, 

6- 7 

Marked files. 

Archiving, 7-46 
Marking files for archiving, 

7- 31 

Master libraries, 6-3 
Master library files, 6-7 
/MASTER switch, 

MAKLIB, 6-7, 6-27 
/MASTER switch example, 
MAKLIB, 6-15, 6-17, 6-18 
Match criteria in file 
comparison, 4-4 
MBEFORE command, 

DUMPER, 7-8, 7-9, 7-53 


MESSAGE command, 

PLEASE, 8-5 

MESSAGE command line format, 
PLEASE, 8-5 
/MESSAGE switch, 

PLEASE, 8-3 
Message variables, 

CREF, 5-10 
DUMPER, 7-57 
FILCOM, 4-12 
MAKLIB, 6-28 
Message -of -the -Day , 2-5 , 

3-1 

Message -of -the -Day , 

Reading a, 3-5 
/MESSAGE-OF-THE-DAY switch, 
RDMAIL , 3-4, 3-5 
Messages , 

CREF error, 5-10 
CREF informational, 5-10 
CREF warning, 5-10 
DUMPER error, 7-57 
DUMPER warning, 7-57 
FILCOM error, 4-12 
MAIL error , 2-3, 2-6 
MAIL warning, 2-6 
MAKLIB error, 6-28 
MAKLIB warning, 6-28 
Perusing your, 3-6 
PLEASE error, 8-6 
PLEASE informational, 8-6 
PLEASE warning, 8-6 
RDMAIL error, 3-7 
RDMAIL warning, 3-7 
Reading all your, 3-5 
Stopping your, 3-6 
Messages on the line 
pr inter , 

Printing your, 3-5 
/MIGRATE switch, 

DUMPER, 7-43, 7-49, 7-55 
Migrated files, 7-1 

Restoring archived and, 
7-50 

Retrieving archived and, 
7-50 

Migrating files, 7-3, 7-43, 
7-49 

Modifying libraries, 6-2, 
6-19 

.MODULE pseudo-op, 6-21 
Modules , 

Code and symbol table in, 
6-25 

Deleting code in, 6-22 
Inserting code in, 6-22 
REL, 6-1 

Relocatable object, 6-1 


Index-14 



INDEX (CONT.) 


Modules in libraries, 
Listing, 6-4 
MOUNT TAPE command, 

DUMPER, 7-4, 7-6 
Mounted tape, 

Identifying a, 7-14 
Mounting a tape, 7-4 
MSINCE command, 

DUMPER, 7-8, 7-9, 7-53 
MTA-DUMPER : , 7-4, 7-5, 7-14 
Multi -line commands , 

MAKLIB, 6-4 
Multi -line entries, 

MAIL, 2-2 
PLEASE, 8-2 

Multi-volume tape set, 7-5 


.NAME pseudo-op, 6-6, 6-21 
New mail, 

notification of, 2-2, 3-1, 

3- 2 

Reading, 3-3 
status of, 2-4, 3-2 
/nL switch, 

FILCOM, 4-4, 4-8, 4-11 
NO CHECKSUM command, 

DUMPER, 7-51 
NO CREATE command, 

DUMPER, 7-52 
NO DIRECTORIES command, 
DUMPER, 7-11, 7-52 
NO FILES command, 

DUMPER, 7-12, 7-52 
NO INDUSTRY command, 

DUMPER, 7-53 
NO INTERCHANGE command, 
DUMPER, 7-53 
NO LIST command , 

DUMPER, 7-13, 7-53 
NO SILENCE command, 

DUMPER, 7-13, 7-55 
Node names, 8-3 
/NOINCREMENTAL switch, 

DUMPER, 7-43, 7-44, 7-55 
/NOLOCALS switch, 

MAKLIB, 6-19, 6-20, 6-27 
/NOLOCALS switch example, 
MAKLIB, 6-20 

Non-files-only directory, 
Sending mail to a, 2-5 
Nonpr ivileged user in 
DUMPER, 7-7 
Nonsharable save file 
comparison, 4-8 
Nonsharable save file types, 

4- 2 


Nonsharable save files, 4-2 
4-7, 4-8, 4-11 
Nonstandard file comparison 
4-8 

Nonstandard file types, 
FILCOM, 4-8, 4-11 
/NOUNLOAD switch, 

DUMPER, 7-22 
/NOWAIT switch, 

PLEASE, 8-3 
/nU switch, 

FILCOM, 4-8, 4-11 


/O switch, 

CREF, 5-4 

Obtaining information about 
libraries, 6-2, 6-4 
Octal codes, 

CREF, 5-13 
FILCOM, 4-13, 4-14 
; OFFLINE file status, 7-49 
Offset address file types, 

4- 2 

One-segment program, 6-4 
Opcode table, 5-2 
Opcode table example, 5-6 
OPDEF and Macro names table 

5- 2 

Operator , 

Communicating with the, 
8-1 

OPERATOR capabilities, 2-5, 
3-2, 7-1 

Output file format, 

ASCII, 4-4 
Binary, 4-8 
Output file header, 

ASCII, 4-4 
Binary, 4-8 

Outstanding PLEASE messages 
Canceling, 8-5 
Overwriting a disk file, 
7-10, 7-27 


/P switch, 

CREF, 5-4 
Parity, 

Setting tape, 7-15 
PARITY command, 

DUMPER, 7-8, 7-15, 7-53 
Period to replace user 
names, 2-6 
/PERUSE switch, 

RDMAIL , 3-4, 3-6 


Index-15 



INDEX (CONT.) 


Perusing your messages, 3-6 
PLEASE, 

Running, 8-1 
Stopping, 8-2, 8-5 
PLEASE at PLEASE program 
level, 8-1, 8-4 
PLEASE at TOPS-20 command 
level, 8-1, 8-2 
PLEASE CANCEL command, 8-5 
PLEASE CANCEL command 
example, 8-5 
PLEASE command , 

Batch job, 8-1 
PLEASE commands, 8-1, 8-4 
PLEASE error messages, 8-6 
PLEASE EXIT command, 8-5 
PLEASE EXIT command example, 
8-5 

PLEASE informational 
messages, 8-6 

PLEASE MESSAGE command, 8-5 
PLEASE MESSAGE command 
example, 8-5 

PLEASE MESSAGE command line 
format, 8-5 

PLEASE /MESSAGE switch, 8-3 
PLEASE /MESSAGE switch 
example, 8-3 

PLEASE message to a node, 
Sending a, 8-3 
PLEASE messages, 

Canceling outstanding, 

8-5 

PLEASE multi-line entries, 
8-2 

PLEASE /NOWAIT switch, 8-3 
PLEASE /NOWAIT switch 
example, 8-3 

PLEASE operator response, 
Saving a, 8-2 
PLEASE program, 8-1 
PLEASE program level, 

PLEASE at, 8-1, 8-4 
PLEASE program level 
example, 8-4 

PLEASE SEND command, 8-4 
PLEASE SEND command example, 
8-4 

PLEASE SEND command line 
format, 8-4 

PLEASE special characters, 
8-2 

PLEASE switches, 8-3 
PLEASE TOPS-20 command 
level example, 8-2 
PLEASE warning messages, 8-6 
/POINTS switch, 

MAKLIB, 6-4, 6-5, 6-27 


/POINTS switch example, 
MAKLIB, 6-5 

Positioning at beginning of 
tape, 7-21 

Positioning at End-of-Tape, 
7-21 

Positioning tape, 7-20 
PPN , 1-2, 5-3 

Preserving a saveset, 7-26 
PRINT command, 

DUMPER, 7-29, 7-54 
Printing directory names 

during SAVE or RESTORE, 
7-11 

Printing filenames during 
SAVE and RESTORE, 7-3 
Printing filenames during 
SAVE or RESTORE, 7-11 
Printing your messages on 
the line printer, 3-5 
Privileged user in DUMPER, 
7-42 

Procedure nesting table, 

5-2 

Procedure nesting table 
example, 5-9 
Producing a file of 

filenames during SAVE, 
7-12 

Producing cross-reference 
listings, 5-2 
Program , 

Compiling a, 5-1, 5-2 
CREF, 5-1 
DUMPER, 7-1 
Executable, 6-1 
FILCOM, 4-1 

LINK, 6-1, 6-2, 6-5, 6-19 

MAIL, 2-1 

MAILER, 2-9 

MAKLIB, 6-1 

One-segment, 6-4 

PLEASE, 8-1 

RDMAIL , 3-1 

Running CREF as a, 5-5 
SCAN, 6-28 
Two-segment, 6-4 
WILD, 6-28 
Program break, 6-4 
Project-programmer number, 
1-2, 5-3 

Protection code during 
RESTORE, 

Specifying, 7-14 
PROTECTION command , 

DUMPER, 7-8, 7-14, 7-54 
PS : <REMARKS > directory, 

2-5 


Index-16 



INDEX (CONT.) 


PS: <REMARKS> example. 
Sending mail to, 2-5 
PS : <SYSTEM> directory, 2-5, 
2-6 

PSECTS, 6-20 
Pseudo-op , 

.ALTER, 6-21 
.ASSOCIATED, 6-21 
Control, 6-20 
.DATE, 6-6, 6-21 
.EDIT, 6-20, 6-21 
.ENDE, 6-20, 6-23 
. ENDI , 6-22, 6-23 
.INSERT, 6-22, 6-23 
.MODULE, 6-21 
.NAME, 6-6, 6-21 
.REINSERT, 6-6, 6-23, 

6-26 

.REMOVE, 6-6, 6-23, 

6-26 

.VERSION, 6-21 
Pseudo-op order figure, 

6-24 

Pseudo-ops, 6-21 


/Q switch, 

FILCOM, 4-4, 4-8, 4-11 
Quick file comparison, 4-4, 
4-8 

QUIT command, 

DUMPER, 7-7, 7-54 


/R switch, 

CREF, 5-4 

Radix-50 characters, 6-21 

RDMAIL , 

Enabling capabilities in, 
3-2 

Running, 3-2 

RDMAIL /ALL switch, 3-4, 

3-5 

RDMAIL /ALL switch example, 
3-5 

RDMAIL date and time, 3-3 

RDMAIL error messages, 3-7 

RDMAIL /HELP switch, 3-4 

RDMAIL /HELP switch example, 
3-4 

RDMAIL help text, 3-4 

RDMAIL /LIST switch, 3-4, 

3-5 

RDMAIL /LIST switch example, 
3-5 

RDMAIL /MESSAGE-OF-THE-DAY 
switch, 3-4, 3-5 


RDMAIL /MESSAGE-OF-THE-DAY 
switch example, 3-5 
RDMAIL /PERUSE switch, 3-4, 
3-6 

RDMAIL /PERUSE switch 
example, 3-6 
RDMAIL program, 3-1 
RDMAIL /STOP switch, 3-4, 
3-6 

RDMAIL /STOP switch example 
3-6 

RDMAIL switches, 3-3 
Invalid, 3-7 
using, 3-4 

RDMAIL warning messages, 

3-7 

Reading a 

Message-of-the-Day , 3-5 
Reading a tape from an 
earlier version of 
DUMPER, 7-16 
Reading a TOPS-10 tape, 
Writing and, 7-16 
Reading all your messages, 
3-5 

Reading and writing tape in 
36 bits, 7-16 

Reading another user's mail 
3-2 

Reading another user's mail 
example, 3-2 
Reading new mail, 3-3 
Recognition, 1-2 
Record numbers, 

Tape, 7-26 

Recording filenames from a 
tape, 7-29 

Recovering from a system 

crash, 7-2, 7-19, 7-37, 
7-45 

Recovery procedure, 

MAIL error, 2-3 
REENTER command, 2-3 
REENTER command example, 

2-3 

REFUSE SYSTEM-MESSAGES 
command, 3-2 

Regular symbols table, 5-2 
.REINSERT pseudo-op, 6-6, 
6-23, 6-26 
.REL file, 6-1 
REL modules, 6-1 
Related edit, 6-21 
Releasing a tape, 7-23 
Relocatable files, 6-1 
Relocatable object modules, 
6-1 

.REMOVE pseudo-op, 6-6, 
6-23, 6-26 


Index-17 



INDEX (CONT.) 


Removing modules from 
libraries, 6-9 
Renaming files during 
RESTORE, 7-26 

Renaming files during SAVE, 
7-24 

REPEAT LOGIN-MESSAGES 
subcommand, 3-1 
/REPLACE switch, 

MAKLIB, 6-7, 6-17, 6-20, 

6- 27 

/REPLACE switch example, 
MAKLIB, 6-18 
/REPLACE switch figure, 
MAKLIB, 6-17 
Replacing modules in 
libraries, 6-17 
REQUEST blocks, 6-6 
REQUIRE blocks, 6-6 
Resending mail, 2-3 
RESET command, 8-2 
RESTORE, 

Printing directory names 
during SAVE or, 7-11 
Printing filenames during 
SAVE and, 7-3 
Printing filenames during 
SAVE or, 7-11 
Renaming files during, 

7- 26 

Specifying file account 
during, 7-14 
Specifying protection 
code during, 7-14 
Supressing directory 
names and filenames 
during SAVE or, 7-13 
RESTORE command, 

DUMPER, 7-23, 7-26, 7-43, 
7-46, 7-54 
Restor ing , 

Continuing, 7-19 
Restoring a directory, 7-46 
Restoring archived and 
migrated files, 7-50 
Restoring files from backup, 
7-46 

Restriction , 

Code insertion, 6-22 
RETRIEVE command, 

DUMPER, 7-43, 7-50, 7-54 
Retrieving an indirect file 
in MAIL, 2-4 
Retrieving archived and 
migrated files, 7-50 
Retrieving user names, 2-1 
REWIND command , 

DUMPER, 7-20, 7-21, 7-54 


REWIND SWITCHING command, 
DUMPER, 7-21 
Running CREF, 5-1 
Running CREF as a command, 
5-5 

Running CREF as a command 
example, 5-5 

Running CREF as a program, 
5-5 

Running CREF as a program 
example, 5-5 
Running DUMPER, 7-6 
Running FILCOM, 4-1 
Running MAIL, 2-1 
Running MAKLIB, 6-3 
Running other programs from 
CREF, 5-6 

Running PLEASE, 8-1 
Running RDMAIL , 3-2 


/S switch, 

CREF, 5-4 
FILCOM, 4-4, 4-11 
SAVE, 

Producing a file of 

filenames during, 7-12 
Renaming files during, 
7-24 

Specifying a checksum 
during, 7-18 
SAVE and RESTORE, 

Printing filenames during 
7-3 

SAVE command, 

DUMPER, 7-23, 7-24, 7-55 
SAVE or RESTORE, 

Printing directory names 
during, 7-11 

Printing filenames during 
7-11 

Supressing directory 
names and filenames 
during, 7-13 
Saveset, 7-2 

Creating a, 7-24 
Deleting a, 7-25 
Preserving a, 7-26 
Skipping a, 7-22 
Saveset name, 7-2 
Specifying a, 7-18 
Saving , 

Continuing, 7-19 
Saving a PLEASE operator 
response, 8-2 

Saving files incrementally, 
7-43 


Index-18 



INDEX (CONT.) 


Saving files on multiple 
tape, 7-2 

SCAN program, 6-28 
SEND command, 

PLEASE, 8-4 

SEND command line format, 
PLEASE, 8-4 

Sending a PLEASE message to 
a node, 8-3 
Sending mail, 

Errors in, 2-3 
Sending mail to a 
non-f iles-only 
directory, 2-5 
Sending mail to 

PS : < REMARKS > example , 

2-5 

Sending mail to PS:<SYSTEM> 
example, 2-5 

Set, 

Switching between volumes 
in a, 7-21 

SET BLOCKING-FACTOR command, 
DUMPER, 7-8, 7-15, 7-16, 
7-55 

SET MAIL-WATCH command, 3-2 
SET TAPE-NUMBER command, 
DUMPER, 7-8, 7-19, 7-55 
Setting logical records, 

7-15 

Setting tape density, 7-15 
Setting tape parity, 7-15 
Sharable save file 
comparison, 4-8 
Sharable save file types, 

4-2 

Sharable save files, 4-2, 
4-7, 4-8, 4-11 
SILENCE command, 

DUMPER, 7-8, 7-13, 7-55 
SINCE command, 

DUMPER, 7-8, 7-9, 7-55 
SIXBIT characters, 6-21 
SKIP command, 

DUMPER, 7-22, 7-56 
SKIP n command, 

DUMPER, 7-20 

Skipping a saveset, 7-22 
Source file spec, 

CREF, 5-3 
DUMPER, 7-23 
FILCOM, 4-1 
MAKLIB, 6-3 
Source files, 

ALGOL compiler, 5-1 
COBOL compiler, 5-1 
Comparing assembly 
language, 4-3, 4-11 
FORTRAN compiler, 5-1 


Source files (Cont.) 

MACRO assembler, 5-1 
MACRO ASSEMBLER, 4-11 
MACRO Assembler, 4-3 
Spaces and tabs in file 
comparison, 4-4 
Spaces in file comparison, 
Comments and, 4-3 
Special characters, 

MAIL subject line, 2-2 
PLEASE, 8-2 
Specifying a checksum 
during SAVE, 7-18 
Specifying a saveset name, 
7-18 

Specifying file account 
during RESTORE, 7-14 
Specifying protection code 
during RESTORE, 7-14 
SSNAME command, 

DUMPER, 7-8, 7-18, 7-56 
Status-Setting commands, 
DUMPER, 7-7, 7-8 
/STOP switch, 

RDMAIL , 3-4, 3-6 
Stopping DUMPER, 7-7 
Stopping FILCOM, 4-3 
Stopping MAKLIB, 6-4 
Stopping PLEASE, 8-2, 8-5 
Stopping your messages, 

3-6 

Subcommand , 

REPEAT LOGIN-MESSAGES, 
3-1 

Subject line, 

MAIL, 2-2 
SUPERSEDE command , 

DUMPER, 7-8, 7-10, 7-56 
Supressing directory names 
and filenames during 
SAVE or RESTORE, 7-13 
Switch , 

/CREF, 5-1, 5-2 


CREF 

/A, 

5-4 

CREF 

/B, 

5-4 

CREF 

/c, 

5-4 

CREF 

/D, 

5-4 

CREF 

/H, 

5-4 

CREF 

/K, 

5-4 

CREF 

/M, 

5-4 

CREF 

/o, 

5-4 

CREF 

/P# 

5-4 

CREF 

/R, 

5-4 

CREF 

/s. 

5-4 

CREF 

/T, 

5-4 

CREF 

/w, 

5-4 

CREF 

/z, 

5-4 


DUMPER /ARCHIVE, 7-43, 
7-48, 7-55 


Index-19 



INDEX (CONT.) 


Switch (Cont . ) 

DUMPER /FULL-INCREMENTAL, 
7-42, 7-44, 7-55 
DUMPER /INCREMENTAL:!”!, 
7-42, 7-44, 7-55 
DUMPER /MIGRATE, 7-43, 
7-49, 7-55 

DUMPER /NOINCREMENTAL, 
7-43, 7-44, 7-55 
DUMPER /NOUNLOAD, 7-22 
DUMPER /TAPE-INFORMATION, 
7-51 

DUMPER /VOLIDS, 7-5 
DUMPER /WRITE-ENABLED, 

7-4 

FILCOM /A, 4-3, 4-11 
FILCOM /B, 4-3, 4-11 
FILCOM /C, 4-3, 4-11 
FILCOM /E, 4-8, 4-11 
FILCOM /H, 4-3, 4-8, 4-11 
FILCOM /nL, 4-4, 4-8, 

4-11 

FILCOM /nU, 4-8, 4-11 
FILCOM /Q, 4-4, 4-8, 

4-11 

FILCOM /S, 4-4, 4-11 
FILCOM /U, 4-4, 4-11 
FILCOM /W, 4-8, 4-11 
FILCOM /X, 4-8, 4-11 
MAKLIB /APPEND, 6-7, 6-27 
MAKLIB /DELETE, 6-7, 6-9, 
6-20, 6-27 
MAKLIB /EXIT, 6-27 
MAKLIB /EXTRACT, 6-7, 

6-11, 6-20, 6-27 
MAKLIB /FIX, 6-5, 6-25, 
6-26, 6-27 

MAKLIB /INDEX, 6-19, 6-27 
MAKLIB /INSERT, 6-7, 6-13, 
6-27 

MAKLIB /LIST, 6-4, 6-27 
MAKLIB /LOAD, 6-4, 6-6, 
6-27 

MAKLIB /MASTER, 6-7, 6-27 
MAKLIB /NOLOCALS, 6-19, 
6-20, 6-27 

MAKLIB /POINTS, 6-4, 6-5, 
6-27 

MAKLIB /REPLACE, 6-7, 

6-17, 6-20, 6-27 
MAKLIB /TRACE, 6-4, 6-5, 
6-20, 6-27 

MAKLIB /WHO, 6-6, 6-25, 
6-26, 6-27 

PLEASE /MESSAGE, 8-3 
PLEASE /NOWAIT, 8-3 
RDMAIL /ALL, 3-4, 3-5 
RDMAIL /HELP, 3-4 
RDMAIL /LIST, 3-4, 3-5 


Switch (Cont . ) 

RDMAIL 

/MESSAGE -OF-THE-DAY, 

3- 4, 3-5 

RDMAIL /PERUSE, 3-4, 3-6 
RDMAIL /STOP, 3-4, 3-6 
Switch arguments, 

MAKLIB, 6-3 
SWITCH . INI file, 

CREF, 5-5 
MAKLIB, 6-3 

SWITCH . INI file example, 
5-6 

Switches , 

ASCII file comparison, 

4- 3 

Binary file comparison, 
4-8 

CREF, 5-3 
FILCOM, 4-2, 4-11 
Invalid RDMAIL, 3-7 
MAKLIB, 6-2, 6-3 
PLEASE, 8-3 
RDMAIL, 3-3 
using RDMAIL, 3-4 
Switching between volumes 
in a set, 7-21 
SYMBOL blocks, 6-20 
Symbols , 

Deleting local, 6-20 
Global, 6-20 
System crash, 

Recovering from a, 7-2, 
7-19, 7-37, 7-45 


/T switch, 

CREF, 5-4 
Table , 

Opcode, 5-2 

OPDEF and Macro names, 5 
Procedure nesting, 5-2 
Regular symbols, 5-2 
Tabs in file comparison, 
Spaces and, 4-4 
TALK command, 2-4 
Tape , 

Dismounting a, 7-5 
Identifying a mounted, 
7-14 

Labeled, 7-3, 7-5 
Mounting a, 7-4 
Positioning, 7-20 
Recording filenames from 
a, 7-29 

Releasing a, 7-23 
Saving files on multiple 
7-2 


Index-20 



INDEX (CONT.) 


Tape (Cont.) 

Transferring between disk 
and, 7-2 

Transferring files from 
disk to, 7-24 
Unlabeled, 7-3, 7-5 
TAPE command, 

DUMPER, 7-8, 7-14, 7-56 
Tape density, 

Setting, 7-15 
Tape drive , 

Assigning a, 7-4 
Tape drive allocation, 7-3 
status of, 7-3 
Tape drive example, 
Assigning a, 7-4 
Tape from an earlier 
version of DUMPER, 
Reading a, 7-16 
Tape parity, 

Setting, 7-15 
Tape record numbers, 7-26 
Tape set, 7-2 

Multi-volume, 7-5 
Verifying another tape in 
a, 7-6 

Tape to disk, 

Transferring files from, 
7-26 

/TAPE-INFORMATION switch, 
DUMPER, 7-51 

Tape-Positioning commands, 
DUMPER, 7-7, 7-20 
Technical notes, 

CREF, 5-14 
MAIL, 2-9 
MAKLIB, 6-41 

Terminating a MAIL message, 
2-2 

TOPS-10 tape, 

Writing and reading a, 
7-16 

TOPS-20 command level, 
PLEASE at, 8-1, 8-2 
TRACE blocks, 6-5, 6-20, 
6-21, 6-26 

TRACE blocks format, 6-41 
/TRACE switch, 

MAKLIB, 6-4, 6-5, 6-20, 
6-27 

/TRACE switch example, 
MAKLIB, 6-6 

Transaction files, 6-3 
Transfer commands , 

DUMPER, 7-23 

Transferring between disk 
and tape, 7-2 

Transferring files by date 
and time, 7-8, 7-9 


Transferring files from 
disk to tape, 7-24 
Transferring files from 
tape to disk, 7-26 
TRANSLATE command, 1-2 
TRANSLATE command example, 
1-2 

Two-segment program, 6-4 
TYPE command, 4-5, 5-6, 6-5 
TYPE command example, 4-5, 
4-6, 5-6, 6-5 

Typing file specs, 1-1, 1-2 


/U switch, 

FILCOM, 4-4, 4-11 
Unlabeled tape, 7-3, 7-5 
UNLOAD command, 

DUMPER, 7-20, 7-23, 7-56 
Update mode file comparison, 
4-4 

User names. 

Duplicate, 2-1 
File of, 2-4 
Invalid, 2-1 
Period to replace, 2-6 
Retrieving, 2-1 
Utilities , 

Invoking the, 1-1 


Variables , 

CREF message, 5-10 
DUMPER message, 7-57 
FILCOM message, 4-12 
MAKLIB message, 6-28 
VDIRECTORY command example, 
7-10 

Verifying another tape in a 
tape set, 7-6 
Version number, 

Edit, 6-21 

.VERSION pseudo-op, 6-21 
/VOLIDS switch, 

DUMPER, 7-5 
Volumes in a set, 

Switching between, 7-21 


/W switch, 

CREF, 5-4 
FILCOM, 4-8, 4-11 
Warning messages, 
CREF, 5-10 
DUMPER, 7-57 
MAIL, 2-6 


Index-21 



INDEX (CONT.) 


Warning messages (Cont.) 
MAKLIB , 6-28 
PLEASE, 8-6 
RDMAIL , 3-7 

WHEEL capabilities, 2-5, 
3-2, 7-1 
/WHO switch, 

MAKLIB, 6-6, 6-25, 6-26, 
6-27 

/WHO switch example, 
MAKLIB, 6-26 
WILD program, 6-28 
Wildcards, 1-2 
DUMPER, 7-23 
/WRITE -ENABLED switch, 
DUMPER, 7-4 


Writing and reading a 
TOPS-IO tape, 7-16 
Writing tape in 36 bits, 
Reading and, 7-16 


/X switch, 

FILCOM, 4-8, 4-11 


/Z switch, 
CREF, 5-4 


Index-22 



Please cut along this line. 


TOPS-20 

User Utilities Guide 
AA-D8 50A-TM 

READER'S COMMENTS 


NOTE: This form is for document comments only. DIGITAL will 

use comments submitted on this form at the company's 
discretion. If you require a written reply and are 
eligible to receive one under Software Performance 
Report (SPR) service, submit your comments on an SPR 
form. 


Did you find this manual understandable, usable, and well-organized? 
Please make suggestions for improvement. 


Did you find errors in this manual? If so, specify the error and the 
page number. 


Please indicate the type of reader that you most nearly represent. 

| | Assembly language programmer 
I | Higher- level language programmer 
I I Occasional programmer (experienced) 

| | User with little programming experience 
I | Student programmer 

I I Other (please specify) 


Name 


Date 

Oraanization 


Telenhone 

Street 

City 

State 

Zin Code 

or 

Country 


BUSINESS REPLY MAIL 

FIRST CLASS PERMIT NO. 33 MAYNARD MASS. 


POSTAGE WILL BE PAID BY ADDRESSEE 


SOFTWARE PUBLICATIONS 

200 FOREST STREET MR1-2/E37 

MARLBOROUGH, MASSACHUSETTS 01752 


Do Not Tear — Fold Here and Tape 







TO PS-20 
User Utilities Guide 
AD-D850A-T 1 


READER’S COMMENTS 

NOTE: This form is for document comments only. DIGITAL will use comments submitted on 
this form at the company’s discretion. If you require a written reply and are eligible to 
receive one under Software Performance Report (SPR) service, submit your com- 
ments on an SPR form. 

Did you find this manual understandable, usable, and well-organized? Please make sugges- 
tions for improvement. 


Did you find errors in this manual? If so, specify the error and the page number. 


Please indicate the type of reader that you most nearly represent. 

□ Assembly language programmer 

□ Higher-level language programmer 

□ Occasional programmer (experienced) 

□ User with little programming experience 

□ Student programmer 

□ Other (please specify) 

Name Date 

Organization Telephone 

Street 

City State Zip Code _ 

or Country 





SOFTWARE PUBLICATIONS 

200 FOREST STREET MR1-2/L1 2 
MARLBOROUGH, MASSACHUSETTS 01752 




Cut Along Dotted Line 





TO PS-20 
User Utilities Guide 
AD-D850A-T 1 


READER’S COMMENTS 

NOTE: This form is for document comments only. DIGITAL will use comments submitted on 
this form at the company’s discretion. If you require a written reply and are eligible to 
receive one under Software Performance Report (SPR) service, submit your com- 
ments on an SPR form. 

Did you find this manual understandable, usable, and well-organized? Please make sugges- 
tions for improvement. 


Did you find errors in this manual? If so, specify the error and the page number. 


Please indicate the type of reader that you most nearly represent. 

□ Assembly language programmer 

□ Higher-level language programmer 

□ Occasional programmer (experienced) 

□ User with little programming experience 

□ Student programmer 

□ Other (please specify) 

Name Date 

Organization Telephone 

Street 

City State Zip Code _ 

or Country 






SOFTWARE PUBLiCATBONS 

200 FOREST STREET MR1-2/L12 
MARLBOROUGH, MASSACHUSETTS 01752 




Cut Along Dotted Line 








UPDATE NOTICE 

TOPS-20 

User Utilities Guide 
AD-D850A-T1 


January 1982 

Insert this Update Notice in the TOPS-20 User Utilities Guide 
to maintain an up-to-date record of changes to the manual. 


Changed Information 

The changed pages contained in this update package reflect an 
updated version (2B) of the MAKLIB utility. 

The instructions for inserting this update start on the next page. 


Copyright ©, 1982, Digital Equipment Corporation. 
All Rights Reserved. 


INSTRUCTIONS 
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The following list of page numbers specifies which pages are to be placed in the TOPS-20 User Utilities 
Guide as replacements for, or additions to, current pages. 

(-Title page 
1-Copyright page 

(-6-3 

1-6-4 


r6-25 

1-6-30.1 


r6-33 

•-6-40 


r 6-43 

1-6-45 


KEEP THIS UPDATE NOTICE IN YOUR MANUAL TO MAINTAIN AN UP-TO-DATE 
RECORD OF CHANGES. 

TYPE AND IDENTIFICATION OF DOCUMENTATION CHANGES. 

Five types of changes are used to update documents contained in the TOPS-20 software manuals. 
Change symbols and notations are used to specify where, when, and why alterations were made to 
each update page. The five types of update changes and the manner in which each is identified are 
described in the following table. 


The Following Symbols and/or Notations 

1. Change bar in outside margin; version num- 
ber and change date printed at bottom of 
page. 

2. Change bar in outside margin; change date 
printed at bottom of page. 

3. Change date printed at bottom of page. 

4. Bullet (•) in outside margin; version number 
and change date printed at bottom of page. 

5. Bullet (•) in outside margin; change date 
printed at bottom of page. 


Identify the Following Types of Update Changes 

1. Changes were required by a new version of 
the software being described. 

2. Changes were required to either clarify or 
correct the existing material. 

3. Changes were made for editorial purposes 
but use of the software is not affected. 

4. Data was deleted to comply with a new ver- 
sion of the software being described. 

5. Data was deleted to either clarify or correct 
the existing material. 
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